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HOW IMPORTANT IS YOUR DATA? 


Years of family photos. Your entire music 
and movie collection. Office documents 
you've put hours of work into. Backups for 
every computer you own. We ask again, how 
important is your data? 


NOW IMAGINE LOSING IT ALL 


Losing one bit - that’s all it takes. One single bit, and 
your file is gone. 


The worst part? You won't know until you 
absolutely need that file again. 


THE SOLUTION 


The FreeNAS Mini has emerged as the clear choice to 
Save your digital life. No other NAS in its class offers 
ECC (error correcting code) memory and ZFS bitrot 
protection to ensure data always reaches disk 
without corruption and never degrades over time. 


No other NAS combines the inherent data integrity 
and security of the ZFS filesystem with fast on-disk 
encryption. No other NAS provides comparable power 
and flexibility. The FreeNAS Mini is, hands-down, the 
best home and small office storage appliance you can 
buy on the market. When it comes to saving your 
important data, there simply is no other solution. 


systems 








Example of one-bit corruption 





The Mini boasts these state-of-the- 
art features: 


¢ 8-core 2.4GHz Intel® Atom™ processor 

¢ Up to 167B of storage capacity 

¢ 16GB of ECC memory (with the option to upgrade 
to 32GB) 

¢ 2x 1 Gigabit network controllers 

« Remote management port (IPMI) 

¢ Tool-less design; hot swappable drive trays 

« FreeNAS installed and configured 





Intel, the Intel logo, Intel Atom and Intel Atom Inside are trademarks of Intel Corporation in the U.S. and/or other countries. 
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STORAGE 


With over six million downloads, 
FreeNAS is undisputedly the most 
popular storage operating system 
In the world. 


Sure, you could build your own FreeNAS system: 
research every hardware option, order all the 

parts, wait for everything to ship and arrive, vent at 
customer service because it hasn‘,, and finally build it 
yourself while hoping everything fits - only to install 
the software and discover that the system you spent 
days agonizing over isn’t even compatible. Or... 


MAKE IT EASY ON YOURSELF 


As the sponsors and lead developers of the FreeNAS 
project, iXsystems has combined over 20 years of 
hardware experience with our FreeNAS expertise to 
bring you FreeNAS Certified Storage. We make it 
easy to enjoy all the benefits of FreeNAS without 
the headache of building, setting up, configuring, 
and supporting it yourself. As one of the leaders in 
the storage industry, you know that you're getting the 
best combination of hardware designed for optimal 
performance with FreeNAS. 


Every FreeNAS server we ship is... 


» Custom built and optimized for your use case 

» Installed, configured, tested, and guaranteed to work out 
of the box 

» Supported by the Silicon Valley team that designed and 
built it 

» Backed by a 3 years parts and labor limited warranty 


http://www.iXsystems.com/storage/freenas-certified-storage/ 
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As one of the leaders in the storage industry, you 
know that you're getting the best combination 

of hardware designed for optimal performance 

with FreeNAS. Contact us today for a FREE Risk 
Elimination Consultation with one of our FreeNAS 
experts. Remember, every purchase directly supports 
the FreeNAS project so we can continue adding 
features and improvements to the software for years 
to come. And really - why would you buy a FreeNAS 
server from anyone else? 
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FreeNAS 1U 

¢ Intel® Xeon® Processor E3-1200v2 Family 

¢ Up to 16TB of storage capacity 

¢ 16GB ECC memory (upgradable to 32GB) 

« 2x 10/100/1000 Gigabit Ethernet controllers 
« Redundant power supply 


FreeNAS 2U 
- 2x Intel® Xeon® Processors E5-2600v2 Family 
« Up to 48TB of storage capacity 
¢ 32GB ECC memory (upgradable to 128GB) 
¢ 4x 1GbE Network interface (Onboard) - 
(Upgradable to 2 x 10 Gigabit Interface) 
« Redundant Power Supply 
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Intel, the Intel logo, the Intel Inside logo and Xeon are trademarks of Intel Corporation in the U.S. and/or other countries. 
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Dear Readers, 





MAGAZINE 


During such rainy days, | presume we all have a lot of time to read more and more. | hope so, and | wish that. 
However, | Know that you are very busy at work, therefore, the weather is not a good indicator to reach this 
conclusion, especially now that we are almost ushering the year 2018. The days which are left are undisputedly 
the busiest days before us. However, | hope that the BSD Magazine will feature on your reading list since we 
believe you have been waiting for it. 


In this issue, we present you an article written by Aobdorrahman Homaei on Military-Grade Data Wiping In 
FreeBSD With BCWipe. You will not only learn how to install BCWipe but also to install BCWipe With 
Multithreaded Mode Enabled. You will know more about BCWipe advanced features and BCWipe in action. 
Besides, there is an article | would like to recommend which will give you more insight into a file system. The 
author, George Siju, will tell you about HAMMER File System Volumes Management and Pseudo File Systems 
Mirroring in DragonFlyBSD. 


lf you would like to learn more about Unix techniques, then Mark Sitkowski’s article is worth a read. Reading his 
article will get you acquitted on how to examine the design of a queuing system, loosely modelled on that used 
by IBM, in its WebSphere MQ Series. 


To add to your reading list, there is this interesting article titled OoenBSD From a Veteran Linux User 
Perspective by Carlos Fenollosa, solely based on his own experiences, which are quite fascinating and 
resourceful as well. His experience has been an eye-opener to many. That’s why we thought it was worthwhile 
to share them with you, our reader. In his sharing, he considers himself an "old-school" Linux admin, and he’s 
felt out of place with the latest changes to the system administration. It’s interesting to see how he appreciates 
modernity. Carlos also agreed to answer a few interesting questions. Therefore, you have a chance to read a 
really great interview with him. 


Of course, that is not all we have in this month’s BSD issue. Please, go to the next page to see a full list of 
publication. | hope you will enjoy reading each one of them, and anticipating for the coming articles in October. 


Lastly, | would like to express my sincere appreciation to the BSD team members for reviewing and 
proofreading, and iXsystems for their constant support and time to make this edition a success. 


lf you have any suggestions or advices that you want to share with the BSD readers, please, feel free to send 
your emails to me. And now, let’s read the articles. 


Enjoy! 
Ewa & Ihe BSD Team 
ewa@bsdmag.org 


IN BRIEF 


In Brief 07 
Fwa & The BSD Team 

This column presents the latest news coverage of 
breaking news, events, product releases, and 
trending topics from the BSD sector. 


SECURITY 


Military Grade Data Wiping In FreeBSD With 
BCWipe 11 
Abdorrahman Homaei 

Data wiping is a process of overwriting data on 
magnetic hard disk, SSD or USB flash by using 
zeros and ones on whole disk or specific zone. As a 
result, no one can recover the sensitive data and 
disk is still usable. You will not only learn how to 
install BCWipe, but also to install BOCWipe With 
Multithreaded Mode Enabled. You will also know 
more about BCWipe advanced features and BCWipe 
in action. 


DRAGONFLYBSD 


HAMMER File System Volumes Management 

and Pseudo File Systems Mirroring in 
DragonFlyBSD 15 
George Siju 

In DragonFlyBSD, the HAMMER filesystem allows us 
to perform functions akin to Logical Volume 
Management in Linux like adding and removing 
volumes from Volume Group or Pools, creating 
Logical Volumes with separate file systems, taking 
Logical Volume snapshot, etc. The reason for the 
choice of DragonFlyBSD and HAMMER file system 
was described in a previous article. A third article will 
follow describing PFS and snapshots management. 


FREEBSD 


Transparent Flow Mapping for NEAT 2/ 
Felix Weinrank 

The NEAT library provides application developers 
with a unified and platform independent API for 
network communication, regardless of the 
underlying network protocol. Felix describes an 
approach to integrate multiplexing functionality into 
the NEAT library, giving application developers a 


Table of Contents 


simple way to use the benefits of mapping multiple 
data streams to a single transport connection 
without additional coding effort. 


UNIX 


Advanced Unix Queuing Techniques 37 
Mark Sitkowski 

Following the discussion of some of the types of 
queuing mechanisms available on Unix, it may be 
beneficial to examine the design of a queuing 
system, loosely modeled on that used by IBM, in its 
WebSphere MQ Series. 


BLOG PRESENTATION 


OpenBSD 

From a Veteran Linux User Perspective 51 
Carlos Fenollosa 

For the first time | installed a BSD box on a machine | 
controlled. The experience has been eye-opening, 
especially since | consider myself an "old-school" 
Linux admin, and I've felt out of place with the latest 
changes on system administration. 


INTERVIEW 


Interview with Felix Weinrank 59 
Ewa & The BSD Team 

Felix Weinrank is a computer scientist from 

Germany. He is currently a Ph.D student in the 
Department of Electrical Engineering and Computer 
Science at Munster University of Applied Sciences. 
His research interests include the SCTP transport 
protocol, low-latency Internet communication, and 
network emulation. 


COLUMN 


The gig economy giant, Uber, has had its 
operating licence suspended by Transport for 
London. Apart from concerns over the way the 
company operates, a more sinister reference was 
made to Greyball software which effectively 
tricks law enforcement and those Uber does not 
wish to deal with. Where should the line be drawn 
between good practice and deception? 61 
Rob Somerville 
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Download syslog-ng Premium Edition 
product evaluation here 


Attend to a free logging tech webinar here 


BalaBit 
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syslog-ng log server 


The world’s first High-Speed Reliable Logging™ technology 


HIGH-SPEED RELIABLE LOGGING 


m above 500 000 messages per second 





m zero message loss due to the 
Reliable Log Transfer Protocol™ 


= trusted log transfer and storage —_ 
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Building MariaDB on FreeBSD 


MariaDB 


You can just use the MariaDB ports in the FreeBSD 
ports tree using the following pattern: 
databases/mariadb(55)?-{client,server}. You can also 
use precompiled packages when available. 


MariaDB can be compiled with spinlocks instead of 
mutexes. This option enables MariaDB “fast 
mutexes". These have disabled by default foraa 
number of years, and it's generally recommended 
not to use them. 


Source: 


httos://mariadb.com/kb/en/library/building-mariadb- 
on-freebsd/ 


The Private Cloud Enabled by 
TrueNAS : Open for Business 








IN BRIEF 


March 14, 2006 marks an important date in the 
history of the IT abstraction Known as the cloud. On 
this day, Amazon introduced the S3 (Simple Storage 
Service) to the world and things have never been the 
same. Fast forward to August, 2017 and Amazon’s 
cloud service, of which S3 is a large part, is a $14.6B 
business and is growing at a rate of more than 50% 
per year. Unlike unified storage, which stores and 
manages data as files or blocks, S3 stores and 
manages data as objects. 


2013 was the last time | found a public mention on 
how many objects are stored on the Amazon storage 
cloud, and that number was 2 trillion. While it is 
unclear what that number is today, one can assume 
it has since tripled to 6 trillion. To put this number in 
perspective, there are currently 7.5 billion people in 
the world. Each person could store 800 of those 6 
trillion objects. A truly astounding number that will 
only continue to increase over time. 


The success of the Amazon S3 is due in large part to 
the many IT and business benefits cloud storage 
provides. Up until very recently, TrueNAS was a fully 
unified storage solution providing file and block 
protocol support for NFS, SMB, AFP, iSCSI, and 
Fibre Channel. TrueNAS 11, released in early July, 
added object storage. This means that TrueNAS 
customers can now build on-premise clouds that are 
fully Amazon S3-compliant. It also means that 
services and applications developed for the S3 can 
be migrated to TrueNAS, bringing these customers 
the benefits of the public cloud in their own data 
center. 


This is an important development on several fronts. 
Despite the rapid adoption of public cloud storage, 
many believe the adoption rate would be closer to 

universal if tt were not for two concerns. One is the 


lingering concern over security and the other is the 
cost at scale. 


Let’s discuss both in detail. Data stored on a public 
cloud is on infrastructure that belongs to and is 
owned by another entity. This would be Amazon for 
53, Google for its Cloud Platform, and Microsoft for 
Azure. This loss of control is a source of concern for 
many IT professionals. If an enterprise owns the 
physical infrastructure on which its data lives, 
safeguards can be taken to prevent unauthorized 
access to the storage hardware and the data. Public 
clouds are multiuser systems where the data can be 
accessed by multiple users and organizations. While 
processes are designed and put in place to prevent 
the commingling of data, they sometimes fail. We all 
have seen or heard in the news where data in the 
cloud is exposed. In addition to the significant cost 
that a business can incur from data leakage 
(especially to a competitor), the business can also be 
subject to legal risk if the leakage involves certain 
classes of data. 


The second concern deals with cost at scale. Since 
public cloud storage employs a pay-as-you-go 
model, it relleves new businesses from the burden of 
having to shell out a large amount of capital to build 
on prem storage infrastructure. Fledgling businesses 
can pay only for the storage they need and use. 
However, this model quickly breaks down as the 
business grows and there is more demand for 
ongoing storage. Case in point: A big cybersecurity 
organization moved from the cloud by using 
iXsystems storage and servers to build a private 
cloud and saved millions by cutting their Amazon S3 
bill by over 80%. A recent iXsystems white paper 
covers the true cost of the public cloud in much 
greater detail. 


Public cloud storage providers charge for their 
services in many ways. One is by the amount of data 
stored on their cloud, and another is by the quantity 
of data retrieved from the cloud. For this exercise, 
let’s just consider the Amazon S3 storage cost. If 
you were to just store 1TB of data on the S83, the 
monthly cost is $26.50. However, if you were to store 
100TB of data, the monthly cost is now $2,872.18. 
Over three years, the cost of storing 1001TB of data 
would be $103,398.48. This is based on information 
from the Amazon AWS Calculator for the US-West 


(Northern California) region. How does that compare 
to a physical array from iXsystems? The TrueNAS 
X10 has a starting price of $5,500. 


So what does this all mean? If you have been using 
the public cloud as a data store and have concerns 
about security and cost, perhaps it is time to 
consider the private cloud option, particularly if you 
already own a TrueNAS appliance. Private cloud with 
a TrueNAS? Yes. It’s here today and open for 
business. 


Steve Wong, Director of Storage Product 
Management 


Source: 


httos://www.ixsystems.com/blog/private-cloud-truen 
as/ 


OpenSSH 7.6 Is Ready For 
Testing & Finishes Gutting SSHv1 





A call for testing has been issued for the upcoming 
OpenSSH 7.6 with its release being imminent. This 
update to OpenSSH deletes the SSH protocol 
version 1 support. Besides removing the rest of 
SSHv1 support, OpenSSH 7.6 also nukes some 
other old code including support for 


hmac-ripemd160 MAC, arcfour, blowfish, and CAST 
ciphers. RSA keys less than 1024 bits are also 
refused. 


Source: 
httos://www.phoronix.com/scan.php?page=news_ite 
m&px=OpenSSH-7.6-Coming-Soon 


SNIA SDC 2017: 20 Years and Still 
Going Strong 


The Storage Networking Industry Association’s 
Software Developer Summit (SNIA SDC) 2017 took 
place just after vVBSDcon 2017 from September 11th 
through 14th in Santa Clara, California. Developers 
and decision makers from the largest storage 
vendors in the industry attended this event, and | 
found it invaluable to my role as iXsystems Senior 
Analyst to attend as well as to speak. 
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While flash-based storage in all its forms is a 
perennial hot topic at the SDC, it has an inevitable 
twist: we are steadily making our way back to 
byte-addressed persistent storage memory, not 
unlike the core memory of the earliest computers but 
in orders of magnitude bigger, faster, and cheaper. 
The first wave of this movement is the Non-Volatile 
Memory (NVM) programming model which is 
flash-native, doing away with many layers of 
abstraction that allow “spinning rust” to appear as 
block devices to a system. 





Open-Source had its strongest presence at the SDC 
in the organization’s 20-year history. | did my part to 
support this by opening the first day with two talks. 
The first demonstrated Open-Source as an ideal 
strategy for creating reference implementations of 
open standards. The second, “Mitigating 
Ransomware Attacks at the Block Level with 
OpenZFS”, described why FreeBSD and FreeNAS 
are great Open-Source solutions for combating the 
real-world threat of ransomware while also serving 
as excellent reference implementations of open 
standards such as network protocols, plus 
techniques straight out of the SNIA Dictionary such 
as RAID and Replication. 
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SNIA has a natural preference for 
permissively-licensed reference implementations of 
the standards they develop, but not a consistent 
track record of delivering and maintaining them. This 
is changing with their Swordfish storage 
management stack that members have prototyped in 
Python and AngularJS under an MIT license. If 
Open-Source is music to my ears, this is the guitar 
solo and | am excited about the organization’s 
sharpening focus on Open-Source. 


The keynotes on the second day continued the 
Open-Source theme with Sage Weil from the Ceph 
project and Martin Petersen from Oracle with 
“Recent Developments in The Linux I/O Stack”. 
OpenZFS specifically came up in an Intel talk when 
the researcher reported that the relatively larger 
128K default block size of ZFS is optimal for use 
with Intel in-CPU encryption accelerators. Allan Jude 
of ZFS Book fame looks forward to seeing how even 
larger block sizes will perform with Intel crypto. 


After flash storage and Open-Source, one hallway 
track theme stood out: the impending loT and 


ransomware bloodbath that will take place on 
consumer information devices. Today, from the 
recent massive Equifax leak to the barrage of 
ransomware attacks at all levels, there are clearly 
some valid concerns being raised that warrant 
changes in behavior by both users and vendors. One 
equal source of both hope and dread is the 
European Union General Data Protection Directive 
which can be thought of as the “strong crypto” of 
personal information privacy. Under the directive, 
E.U. countries will be required to establish a system 
that allows companies and organizations to report 
“potential” data breaches, and to provide their 
constituents the ability to erase themselves from any 
system containing Personally Identifiable Information 
(PIl). 


This “right to be forgotten” is so attractive that 
citizens are already beginning to exercise it and 
unfortunately, the directive offers little guidance in 
practical implementation and thus will be navigated 
in the courts. What is clear is that organizations will 
need to appoint a Data Protection Officer to assess 
the company’s compliance with the GDPR and 
respond to GDPR-related inquiries. From an abuse 
perspective however, will criminals be able to 
strategically destroy evidence in the name of 
privacy? Will identity thieves double as identity 
assassins for want of well-defined and proven 
security mechanisms for validating information 
destruction requests? Will the arrival of employees at 
work constitute the potential for personal information 
exfiltration? With nine months remaining until the 
GDPR directive becomes fully enforceable, will 
company policies and vendor solutions be mature 
enough for widespread compliance? Finally, 
consider that U.S. companies like Google are not 
exempt from the GDPR if they collect personal 
information from E.U. citizens during the normal 
course of business. Rest assured, tools such as 
FreeNAS and TrueNAS are here to help both comply 
with the GDPR using per-user datasets and 
encryption at rest, plus mitigate ransomware attacks 
with block-level snapshots and clones. 


The real-world challenge of political and mechanical 
compliance with the E.U. GDPR is only one example 
of the fascinating and timely topics of discussion 
within SNIA and is why | find participation in SNIA 
events so valuable. Many SNIA members occupy the 
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top levels of their respective employers yet their 
passion drives them to volunteer with SNIA by giving 
talks, chairing committees, and organizing events 
like the SDC. If this balance of experience, passion, 
and willingness to leave your marketing guns at the 
door sounds like you, | invite you to learn more 
about SNIA and consider joining. 


Michael Dexter, Senior Analyst, iXsystems 


Source: 
httos://www.ixsystems.com/blog/snia-sdc-201 7/ 


FreeBSD 10.4-RC1 Now Available 


v7 





FreeBSD 


The developers of FreeBSD have made available the 
first RELEASE candidate for version 10.4. Check out 
the detailed list of changes at the mailing list page. 
Download the latest ISO here. Note that RC2 may be 
released shortly after the time of this posting. 


Source: 


https://www.freebsdnews.com/201 7/09/22/freebsd- 
10-4-beta3/ 


SECURITY 


Military Grade Data Wiping 


In FreeBSD With BCWipe 


Inside 
¢ What Is Data Wiping 
¢ What Is BCWipe 


¢- How To Install BCWipe 





¢ How To Install BOWipe With Multithreaded Mode Enabled 


¢ BCWipe Advanced Features 


¢ BCWipe In Action 


What Is Data Wiping 


Data wiping is a process of overwriting data on 
magnetic hard disk, SSD or USB flash by using 
zeros and ones on whole disk or specific zone. As a 
result, no one can recover sensitive data and disk is 
still usable. 


Varieties: 
1. Software-based wiping 


This type of wiping is carried out by a software that 
is installed on the drive. 
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2. Hardware-based wiping 
This type of wiping needs some external device. 


Don’t confuse data wiping with file deletion.File 
deletion only removes direct pointers to the data and 
makes the data recovery possible with common 
software tools. Unlike degaussing and physical 
destruction, which render the storage media 
unusable, data wiping removes all information but 
still leaves the disk operable. Data erasure may not 
work completely on flash based media such as Solid 
State Drives and USB Flash Drives. This is because 
such devices can store remnant data which is 
inaccessible to the wiping technique. Moreover, the 


data can be retrieved from the individual flash 
memory chips in the device. 


Wiping software uses many techniques to ensure 
data is not recoverable like: 


1. German BCI/VSITR 7-pass wiping 


2. U.S. DoD 5220.22M 7/-pass extended 
character rotation wiping with last pass verification 


3. U.S. DoE 3-pass wiping 

4. 35-pass Peter Gutmann's wiping 
5.  /-pass Bruce Schneier's wiping 
6. 1-pass wiping by zeroes 

What Is BC Wipe 


BCWipe securely erases data from magnetic and 
solid-state memory. BCWipe repeatedly overwrites 
special patterns to the files or frees space to be 
destroyed. In normal mode, 35 passes are used (of 
which 8 are random).The p used were recommended 
in an article by Peter Gutmann entitled "Secure 
Deletion of Data from Magnetic and Solid-State 
Memory". In quick mode, U.S. DoD(Department of 
Defence) 5220.22-M standard is used with 7 pass 
wiping. In custom mode, U.S. DoD 5220.22-M 
standard is used with user defined number of 
passes. 


How To Install BCWipe 


BCWipe is available on FreeBSD ports tree, and you 
can easily install it. 


# make -C /usr/ports/security/bcwipe 
install clean 


Or, you can install BCWipe with PKG mechanism: 
# pkg install bcwipe 


How To Install BCWipe With Multi-threaded Mode 
Enabled 


BCWipe has no compile option through FreeBSD 
port mechanism. Instead, you can rebuild BCWipe 
with multi-threading mode option : 
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# cd /usr/ports/security/bcwipe/ 
# make fetch extract 

# cd work/bcwipe-1.9-9/ 

# ./configure -enable-pthreads 

# make install clean 

BCWipe Advanced Features 


Bcwipe has useful features that make wiping 
process more suitable. 


—-n <delay> 


Wait delay seconds between wiping passes. Modern 
enterprise level storage systems (NAS, disk arrays 
etc.) employ powerful caches. To avoid undesirable 
caching effects, BCWipe allows users to insert 
adjustable delay between wiping passes. Please 
note that when wiping with delay between passes, 
the disk space is freed after the last pass. 


—B Disables direct IO mode 


when wiping block devices 
-t <threads> 


Wipes and verifies block devices in multi-thread 
mode. BCWipe runs worker threads. Useful for 
wiping multiple disk volumes. 


-S (wipe file slack) 


Wipes files’ slack. File slack is the disk space from 
one end of a file to the end of the last cluster used 
by that file. Cluster refers to the minimal portion of 
disk space used by the file system. 


-s Uses ISAAC random number generator by 
Bob Jenkins 


Default is SHA-1 (Secure Hash Algorithm). ISAAC is 
random faster than SHA-1. 


-F (wipe free space) Wipes free space on 
specified filesystem. 


-b (block device) Wipes contents of block 
devices 


BCWipe In Action 


In this section, we describe a real scenario with 
BCWipe. 


Issue the following command to get more 
information about BCWipe: 


# bcwipe 


Tip: in real-world scenario, people want to wipe out 
free space on whole mounted disks (/ ). However, 
the bcwipe command must be issued with caution. 


To wipe free space: 
# bcwipe -F /mnt/ 


This command will wipe out free space on /mnt/ 
path or whole mounted disks on this path. 


# bcwipe -Fv -mt /mnt/ 


This command wipes out free space on /mnt/ 
directory with 1-pass in verbose mode. 


=—Mt refer to l=pass. 
To wipe a specific file: 
# bcwipe -v -mz wipe.me 


This command wipes wipe.me file with 1-pass 
wiping by zeroes in verbose mode. 


# bcwipe -Fv -mg -t 5 /mnt/ 


This command wipes free space on /mnt/ directory 


with 35-pass Peter Gutmann's scheme by 5 threads 


in verbose mode. 
To wipe a specific folder: 
# bcwipe -rv /tmp/ 


This command wipes /tmp/ directory recursively 
with Peter Gutmann's scheme in verbose mode. 


To wipe block device: 


# bcwipe -v -mz -t2 -b /dev/da0 


This command wipes /dev/da0O (USB flash) with 2 
threads by 1-pass zeroes in verbose mode. 


The point is, USB flash is not mounted and all of the 
data will be destroyed. 


Conclusion 


BCWipe along with FreeBSD give you military-grade 
functionalites, ensuring your sensitive data will not 
fall into the wrong hands. 


Useful Links 


http://nvlpubs.nist.gov/nistopubs/SpecialPublications/ 
NIST.SP.800-88r1 .pdf 


https://www.jetico.com/linux/ocwipe-help/wu_using. 
htm 


https://www.nsa.qgov/resources/everyone/media-des 
truction/ 


https://www.usenix.org/legacy/events/fast1 1/tech/ful 
|_ papers/Wei.pdf 


https://www.sans.org/reading-room/whitepapers/inci 
dent/secure-file-deletion-fact-fiction-631 
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TRUENAS® PROVIDES MORE PERFORMANCE, FEATURES, AND CAPACITY PER- 
DOLLAR THAN ANY ENTERPRISE STORAGE ARRAY ON THE MARKET. 


Introducing the TrueNAS X-Series: Perfectly suited for core-edge configurations and enterprise 
workloads such as backups, replication, and file sharing. 


* Unified: Simultaneous SAN, NAS, and object protocols to support multiple applications 
* Scalable: Up to 120 TB In 2U and 720 TB in 6U 

* Safe: High Availability ensures business continuity and avoids downtime 

* Reliable: Uses OpenZFS to keep data safe 

* Trusted: TrueNAS is the Enterprise version of FreeNAS®, the world’s #1 Open Source SDS 
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Systems Mirroring in DragonFlyBSD 


In DragonFlyBSD, the HAMMER filesystem allows us to perform functions akin to Logical Volume Management 
in Linux, like adding and removing volumes from Volume Group or Pools, Creating Logical Volumes with 
separate file systems, taking Logical Volume snapshot, etc. This activity part of this article was done on a 
DragonFlyBSD Installation on a Debian Stretch Linux Kernel Virtual Machine with one 100 GB and four 1 TB 
qcow2 hard disks. The reason for the choice of DragonFlyBSD and HAMMER file system was described in a 
previous article. A third article will follow describing PFS and snapshots management. 


Formating the 4 1TB disks with HAMMER file system 


First, let us see our System mount setup soon after installing the DragonFly on the 100 GB hard disk. 


dflyl# df —h 


Filesystem 
ROOT 


devfts 


/dev/serno/QM00001.sla 


BUILD 

/build/usr. 
/OULLG/ Var 
/bouild/var. 
/build/var. 
/build/var. 
/build/var. 
tmpfs 


procrs 


obj 
Crasn 
cache 
spool 
log 


tmp 


dflyl# mount 


ROOT on 7 


devfs on /dev 


/aev/ serno/OM00001L<sla on boot 


(hammer, noatime, 


BUILD on /build 


(devfs, nosymfollow, 


Avail Capacity 


Size Used 
760.0G I12607M 75.26 
1024B 1024B OB 
1022M 502M 578M 
19.5G 219M 19.36 
£92.56 ZAM! On 3G 
19.5G 219M 19.3G 
19.5G ZLOM 19.36 
19.5G 219M 19.3G 
Oi OG 219M 19.36 
19a OG 219M 19.36 
236M OB 236M 
4096B 4096B OB 
local) 

Local) 
(uts, Local) 

Loca.) 


(hammer, noatime, 


Z 


o\° 


100% 


30 


o\P 


oe 


kA 
oa? 


fk 
oa? 


A 
oe 


fk 
oe 


fk 
oa? 


A 
oe 


© 
oP 


100% 


15 


Mounted on 
/ 

/dev 

/boot 
/build 
(usr ob) 
/var/ crash 
/var/cache 
/var/spool 
PTary 106 
/var/tmp 
/tmp 


{OLOC 


/build/usr.obj on /usr/obj (null) 


/oULLO/ Var Crash. on. /var/crash: (nul) 


/build/var.cache on /var/cache (null) 


(/ouLld/ var cspool. on /var7spool. (mull) 


jour la/var og. on jvar/ log (null) 


Jour la/var<tmp:on../var/tmp (nwl.) 


tmots- On: tmp? ‘(empts; Local) 


procts On /proece (procts,. local) 


Let us look at the hard disks available to us: 


dflyl# ls /dev/ad* 


/dev/ad0O /dev/ad0sl /dev/ad0sla /dev/ad0slb 


dflyl# ls /dev/da* 


/dev/da0 /dev/da0s0 jaev/dal /dev/dals0 
(Gey (Gas /dev/da3s0 


IDE Disks start with ad, whereas SATA Disks start with da. 


dflyl# dmesg | grep ado0O 


ado: 


1O2400MB <QEMU HARDDISK 2.5+> at ataO-master WDMA2 


dflyl# dmesg | grep da 


da0O 


da0: 


GaUe 


da0: 


da0: 


dal 


dal: 


dal: 


ders 


dal: 


da2 


da2: 


daz 


da2: 


Gda.< 


da3 


da3: 


das 


da3: 


da3: 


at ahci0O bus O target O lun 0 


<SATA QEMU HARDDISK 2.5+> Fixed Direct Access SCSI-4 device 
Serial Number QMOOQOO5 
150.000MB/s transfers 


1024000MB (2097152000 512 byte sectors: 255H 63S/T 130541C) 


at enc) bus. barges. sum} 


<SATA QEMU HARDDISK 2.5+> Fixed Direct Access SCSI-4 device 
Serial Number QMOO0OO0OQ7 
150.000MB/s transfers 


1024000MB (2097152000 512 byte sectors: 255H 63S/T 130541C) 


at, ahnci 0. bus: 2 Large 0. iin .0 


<SATA QEMU HARDDISK 2.5+> Fixed Direct Access SCSI-4 device 
Serial Number QMOOOO9 
150.000MB/s transfers 


IQ2A2Q000MB: (209 7TS2000 512 byte sectors: -255H: 635/77 130541) 


at, ancr0) Dus 2 targqee ‘0 Lun. 0 


<SATA QEMU HARDDISK 2.5+> Fixed Direct Access SCSI-4 device 
Serial Number QMOOO11 
150.000MB/s transfers 


1024000MB (2097152000 512 byte sectors: 255H 63S/T 130541C) 
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/dev/ad0sld 


/dev/daZ 


/dev/ad0sle 


/dev/da2s0 


Let us now format the four 1TB Hard Disks with the HAMMER file system. We need to specify a LABEL to 
each HAMMER file system during format. Here, we create a HAMMER file system spanning two physical 
volumes or disks. 

dflyl# newfs hammer -L POOL1 /dev/da0 /dev/dal 

Volume 0 DEVICE /dev/da0 size 0.98TB 

Volume 1 DEVICE /dev/dal size 0.998TB 

initialize freemap volume 0 

initializing the undo map (1024 MB) 

initialize freemap volume 1 

HAMMER version 7 


2 volumes total size lesbo die 


froot=volume: /dev/da0 
boot-area-size: S20 0KB 
memory-log-size: ZOO. NOK 
undo-buffer-size: ie00.GE 
total-pre-allocated: 1.02GB 
rou: e596db85-92ad-1lle/-944b-535400e58e52 


dflyl# newfs hammer -L POOL2 /dev/da2 

Volume 0 DEVICE /dev/da2 size 0.98TB 
initialize freemap volume 0 

initializing the undo map (1024 MB) 

HAMMER version 7 


1 volume total size QO.98TB 


roOoE=Vvolume: /dev/da2 
boot-area-size: S24 00KB 
memory-log-size: Z256.00KB 
undo-buffer-size: 1.QQGB 
total-pre-allocated: 1.02GB 
PS 1c? 936b2e56-92ae-lle/-944b-535400e58e52 


Mounting the HAMMER File Systems 


dflyl# mkdir /POOL1 /POOL2 
dflyl# ls /POOL* 
/POOL1: 


/POOL2: 
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/etc/fstab entries for mounting the filesystems during boot or with mount command 


# Our POOLS 


/dev/da0s0:/dev/dals0 /POOL1 hammer rw i 
/dev/da2s0 /POOL2 hammer rw 
dflyl# mount -a 

mount: Device busy 

mount: Device busy 

dflyl# mount 

ROOT on / (hammer, noatime, local) 

devfs on /dev (devfs, nosymfollow, local) 

/dev/serno/QMO00001.sla on /boot (ufs, local) 

BUILD on /build (hammer, noatime, local) 

JOULE /USr.0b7 om /usr/ob7 (awk) 

/ODuULLOy/Var<Ccrash or /¥var/ Crash. (nul) 

/build/var.cache on /var/cache (null) 

/build/var.spool on /var/spool (null) 

/builda/var. Log on. /var/log. (null) 

jour la/var.tmp:-on /vaer/timp (ull) 

tnipis on Simp. (cmpis, Local) 

PEOCES: (On. /proc *(procis, J10ca |) 

POOL1 on /POOL1 (hammer, noatime, local) 

POOL2 on /POOL2 (hammer, noatime, local) 

dflyl# df -h 

Filesystem Size Used Avail Capacity Mounted on 
ROOT P6256 AZOIM FPSe26 2% / 

devfs 1024B 10248 OB 100% /dev 
/dev/serno/QM00001.sla 1022M 362M 578M 38% 7 DOOt 
BUILD 19. 5G Z1L9M. 19.36 1% Oi 
/oua Vay asreob 4 19.5G 219M 19.3G 1% /usr/obj 
/build/var.crash 19.5G 219M 19.3G 1% pTar/ Crash 
/build/var.cache 19.5G 219M 19.3G 1% /war/cache 
/build/var.spool 19.5G 219M 19.3G 1% /var/spool 
/build/var.log 19.5G 219M 19.3G 1% /var/1log 
(OULLOy vars bmp 19.5G 219M 19.3G 1% /var/tmp 
tmpfs 236M OB 236M 0% /tmp 
procis 4096B 4096B OB 100% / DOC 
POOL1 1999G 203M 1999G 0% /POOL1 
POOL2 999G 203M 999G 0% f/POOLZ 


Creating and mounting Pseudo File Systems 


Initially, we will create Pseudo File Systems such 
that : 


POOL1 houses Master PFSes 
POOL2 houses Slave PFSes for mirroring 


By convention, PFSes are created in the "pfs" 
directory under the Hammer Mother File system. 


Creating Master PFS ISOs in POOL1 


dt Lyi iced: (POOL1/ 

dflyl# ls 

dflyl# mkdir pfs 

drivlg ¢<d. pis 

dflyl# hammer pfs-master ISOs 

Creating PFS#1 succeeded! 

ISOS 
synce-beg-tid=0x0000000000000001 


sync-end-tid=0x0000000100008020 


shared-uuid=0ael913f-92bb-11e7-944b-535400e58e 
SZ 


unique-uuld=0ael91f8-92bb-11e7/7-944b-535400e58e 
DZ 


label="" 
prune-min=00:00:00 
operating as a MASTER 


Snapshots directory defaults to 
/var/hammer/<pfs> 


Null mounting PFS under the Mother file system 


dflyl# cd /POOL1/ 

dflyl# ls 

pfs 

dflyl# mkdir ISOs 

/etc/fstab entry for master PFS for mounting during 
boot, or with mount command. 

# Our Master PFS mounts 


/POOL1/pfs/ISOs 
null Cw 


/POOL1/ISOs 


Relevant output of "mount" command 
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dflyl# mount -a 
dflyl# mount 


POOL1 on /POOL1 (hammer, noatime, local) 


POOL2 on /POOL2 (hammer, noatime, local) 


/POOL1/pfs/@@-1:00001 on /POOL1/ISOs 
local) 


(lbs 


Creating Slave PFS ISOs in POOL2 


We will use these for mirroring data from Master PFS 
ISOs in POOL1. 


For PFS mirroring to take place, shared-uuid of 
Slave PFS should be same as Master PFS 


dflyl# hammer pfs-slave ISOs 
shared-uuid=O0ael913f-92bb-11le7-944b-535400e58e 
oP 


Creating PFS#1 succeeded! 
ISOs 
sync-beg-tid=0x0000000000000001 


sync-end-tid=0x0000000000000001 


shared-uuid=0ael 913f-92bb-11le7-944b-535400e58e 
7 


unique-uuld=S5ed24fd0-92bc-11le/-944b-535400e58e 
Dz 


label="" 
prune-min=00:00:00 
operating as a SLAVE 


Snapshots directory defaults to 
/var/hammer/<pfs> 


Note : Slave PFSes should not be mounted! 


Configure continuous mirroring using 
“mirror-stream" 


dflyl# hammer mirror-stream /POOL1/ISOs/ 
/POOL2Z/ pEs/1sS0s 


Prescan to break up bulk transfer 
(208) 


Prescan 1 chunks, total O MBytes 


Checking mirroring from POOL1 to POOL2 by 
looking at the number of files created 


dflyl# cd /POOL1/1ISOs/ && 1s -1 | 
/POOL2Z/pfs/ISOs/ && 1s -l | we -l 


we -l && cd 


281 


Za) 


dflyl# cd /POOL1/ISOs/ && ls -l1 | we -l && cd 
/POOL2/pfs/ISOs/ && ls -l | we -l 

389 

356 
adflyl# cd. /POOLL/TSOs/ €&& ls -lk | we =1L 6&.-cd 
(/POOLZ/PpES/1TSOS/ -&e ls: =d; ||| weal 

420 

385 
dflyl# cd /POOL1/ISOs/ && ls -1 | we -l && 
ore 5 && cd /POOL2/pfs/ISOs/ && 1s -l | we 

SO) 

493 
dflyl# cd /POOL1/ISOs/ && ls -l | we -l && 
eaoee 5 && cd /POOL2/pfs/ISOs/ && ls -l | we 

516 

493 
dflyl# cd /POOL1/ISOs/ && 1s -l | we -l && 

wc 


sleep 5 && cd /POOL2/pfs/ISOs/ && ls -l | 
== ull 


536 


220 


Mirroring can be continued even after reboot by 
adding the following entry to cron: 


@reboot hammer mirror-stream /POOL1/ISOs/ 
/POOL2Z/pis/ ISOs 


Creating Second Slave Mirror to do a one shot 
mirroring using "mirror-copy" 


This operation ends once mirroring is complete, and 
does not go on continuously like "“mirror-stream" 


dflyl# cd /POOL2/pfs/ 

dflyl# ls 

LSS 

dflyl# hammer pfs-status /POOL1/1SOs/ 
j POOUIS ISOS] PFS#1 { 


sync-beg-tid=0x0000000000000001 


sync-end-tid=0x0000000100020e10 


shared-uuld=0ael913£-92bb-11e7/7-944b-535400e58e 
Dy, 


unique-uuld=0ael91f8-92bb-11e7/7-944b-535400e58e 
DZ 
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label="" 
prune-min=00:00:00 
operating as a MASTER 


Snapshots directory defaults to 
/var/hnammer/<pfs> 


} 


dflyl# hammer pfs-slave ISOs2 
shared-uuid=0ael 913f-92bb-11e7-944b-535400e58e 
SZ 


Creating PFS#2 succeeded! 
LSOSZ 
sync-beg-tid=0x0000000000000001 


sync-end-tid=0x0000000000000001 


shared-uuld=0ael913£-92bb-11e7/-944b-535400e58e 
a7 


unique-uuld=ce39fcdb-92cb6-1le/-944b-535400e58e 
5Z 


label="" 
prune-min=00:00:00 
operating as a SLAVE 


Snapshots directory defaults to 
/var/hammer/<pfs> 


dflyl# hammer mirror-copy /POOL1/ISOs/ 
/POOL2/pfs/ISOs2 


Prescan to break up bulk transfer 
Prescan 1 chunks, total O MBytes (442760) 
Mirror-read /POOL1/ISOs/ succeeded 

dflyl# cd /POOL2/pfs/ISOs2/ && ls -1 | we -l 


L3o4 


Adding a second Physical Volume to POOL2 


This will format the device and add all of its space 
to filesystem. 


A HAMMER file system can use up to 256 volumes. 


dflyl# hammer volume-add /dev/da3s0 /POOL2 
/dev/da2s0 
/dev/da3s0 
dflyl# df -h |grep POOL 


POOL 
0% /POOL1 


L999G ZUSM 9996 


POOL2 LI ISG ASM: “9966 
0% /POOL2 
/POOL1/pfs/@@-1:00001 LOQIG ZUSM: L9G 


0% /POOL1/1ISOs 


The new volume will be automatically mounted. So if 
you try to mount manually again, you will get the 
following message: 


kernel: hammer_vfs_ mount: The volumes are 
probably mounted 


You can make changes permanent by editing 
"/etc/fstab" i.e. adding the new device to the existing 
"POOL2" entry as shown 


f/aev/aa2s0:/dev/da3s0 / POOL? 


hammer rw al cls 


Check if the mirroring process is at work after 
boot 


dflyl# ps aux | grep mirror 


LOO ooe: W220 Oi.7 BOUL? 2288 2 10+ 
52 5SAM 0:00.01 hammer mirror-stream 
/POOL1/1ISOs/ /POOL2/pfs/ISOs 

root Sor. Wel 20erI “Z2AVGIG 1340 2 [1+ 
52 55AM 0:00.03 hammer mirror-stream 
/POOL1/ISOs/ /POOL2/pfs/ISOs 

Loot Soo: Ws “OT 55278 1248 2 [1+ 
5:53AM 0:00.00 hammer mirror-stream 
/POOL1/1ISOs/ /POOL2/pfs/ISOs 

root 897 0.0 O.1 636 504 3 Rit 
5:55AM 0200201 “grep: mirror 


Simple check to see if Master and slave are in 
sync 


dflyl# cd /POOL1/1ISOs/ && 1s -l | we -l && 
sleep 5 && cd /POOL2/pfs/ISOs/ && 1s -l 
=k 


| we 


Lae 


BLA 


Advanced check to see if Master and Slave are in 
sync 


dflyl# hammer pfs-status /POOL1/1SOs 
sync 


|. Grep 
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sync-beg-tid=0x0000000000000001 
sync-end-tid=0x0000000100029880 


dflyl# hammer pfs-status /POOL2/pfs/I1SOs | 
grep sync 


sync-beg-tid=0x0000000000000001 


sync-end-tid=0x0000000100029880 


HowTo: Disaster recovery if the Master PFS 
/POOL1/pfs/ISOs is destroyed. 


Destroying Master PFS /POOL1/pfs/ISOs 
mounted on /POOL1/ISOs 


dfly1# hammer pfs-destroy /POOL1/pfs/ISOs 


You have requested that PFS#1 () be destroyed 


Do you really want to do this? [y/n] y 
This PFS is currently setup as a MASTER! 


Are you absolutely sure you want to destroy it? [y/n] 
y 


Destroying PFS#1 () in 5 4 3 2 1.. starting destruction 
pass 


ofs-destroy of PFS#1 succeeded! 


Ok, we still have the files on the Slave PFS 
/POOL2/pfs/ISOs. So, we can take the following 
steps for Disaster Recovery: 


Upgrade Slave PFS to become a Master PFS. 
Create a new Save PF . 


Reconfigure mirroring from New Master PFS to new 
Slave PFS . 


To start the disaster recovery process, first, we have 
to stop all mirroring processes to the Slave. 


dflyl# ps aux | grep mirror 
LOOL Seo: O60: ~Oie2 S0T2 ZO @ 


52:53AM 0:00.01 hammer mirror-stream 
/POOL1/1ISOs/ /POOL2/pfs/ISOs 


LO+ 


LOOL Sol: (O20 O61) 21006 bSO- JZ. Lieb 
52 534M 0:00.06 hammer mirror-stream 
/POOL1/ISOs/ /POOL2/pfs/ISOs 

OOS Soo OO. 70.7: DOS UZ ae. Sele 
5:53AM 0:00.00 hammer mirror-stream 
/POOL1/ISOs/ /POOL2/pfs/ISOs 

root G29. 0) Oil 636 SUO:: . 3: Rast 
6:13AM 0:00.00 grep mirror 

dflyl# pkill -f “hammer mirror-stream 
/POOL1/ISOs/ /POOL2/pfs/ISOs" 

dflyl# ps aux | grep mirror 

LOOU O28. De? i0e1 3524 L460 38° S04 
6:14AM O00: Ol. (Gee: Wao 


Upgrading Slave PFS to Master 


The PFS will be rolled back to the current end 
synchronization transaction id 


(removing any partial synchronizations), and it will 
then become writable. Slave PFSes are not writable 
in the normal way. 


dflyl# hammer pfs-upgrade /POOL2/pfs/ISOs 


pfs-upgrade of PFS#1 () succeeded 


Mounting the new master and deleting the fstab 
entry for old master 


dflyl# cd /POOL2 
dflyl# ls 
pfs 


dflyl# mkdir ISOs 


/etc/fstab changes 
# Our Master PFS mounts 


(POOL2Z/pPES/ ISOS /POOLZ/1TSOs 


nad lL CW 


Unmounting old master and checking if the new 
Master PFS was mounted. 


dflyl# umount /POOL1/ISOs 


dflyl# mount | grep POOL 


POOL1 on /POOL1 (hammer, noatime, local) 
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POOL2 on /POOL2 (hammer, noatime, local) 


/POOL2/pfs/@@-1:00001 on /POOL2/ISOs 
local) 


Ci Ga ley 


Creating a new slave in POOL1 to mirror from 


new master /POOL2/ISOs 
ativyis cd (POOL 
dflyl# ls 

LOS pfs 
dflyl# cd pfs 
dflyl# ls 


dflyl# hammer pfs-status /POOL2/1SOs/ | 
shared-uulid 


grep 


shared-uuld=0ael913£-92bb-11e7/-944b-535400e58e 
57 


dflyl# hammer pfs-slave ISOs 

shared-uuid=0ael913£-92bb-11e7-944b-535400e58e 

52 

Creating PFS#2 succeeded! 

TOUS 
sync-beg-tid=0x0000000000000001 
sync-end-tid=0x0000000000000001 


shared-uuid=O0ael 913f-92bb-11e7-944b-535400e58e 
52 


unique-uuld=8 lbdeecc-936c-11e7/7-b359-535400e58e 
52 

label="" 

prune-min=00:00:00 

operating as a SLAVE 


Snapshots directory defaults to 
/var/hammer/<pfs> 


dflyl# hammer mirror-copy /POOL2/I1SOs/ 
/POOLI/ pEs7 Loos 


Prescan to break up bulk transfer 
(729160) 


Prescan 1 chunks, total O MBytes 


Mirror-read /POOL2/1ISOs/ succeeded 


dflyl# cd /POOL2/ISOs/ && ls -1 | we -l && 


sleep 5 && cd /POOL1/pfs/ISOs/ && 1s -l | we 
-1 

2279 

2279 
dflyl# hammer pfs-status /POOL2/I1SOs/ | grep 


sync 
sync-beg-tid=0x0000000000000001 
sync-end-tid=0x00000001000318a0 


dflyl# hammer pfs-status /POOL1/pfs/ISOs/ | 
grep sync 


sync-beg-tid=0x0000000000000001 


sync-end-tid=0x00000001000318a 


Start mirroring from new Master PFS to new 
Slave PFS using “mirror-stream” 


dflyl# nohup hammer mirror-stream /POOL2/I1SOs/ 
/POOL1/pfs/ISOs & 
[1] 1046 


GPa. oes au: lil; AGeep, Tair oa 


LOOL hOAG “Oa “O47 5012 ZS08 2 SO 
7:14AM 0:00.01 hammer mirror-stream 
/POOL2/1SOs/ /POOL1/pfs/ISOs 

Loot ROLE OO “Od Barge WG: ae ad! 
7:14AM 0:00.01 hammer mirror-stream 
/POOL2/1ISOs/ /POOL1/pfs/ISOs 

rOOEL POAG OUni0)' Osc 5oOZS Vo, -2 SO) 
7:14AM 0:00.01 hammer mirror-stream 
/POOL2/1ISOs/ /POOL1/pfs/ISOs 

LOO POO: ae: Wao 3480 1428 2 Ri+ 
7:14AM 0200.00 Ore “mirror 


You can continue the mirroring operation even after a 
reboot using the following Cron entry: 


@reboot hammer mirror-stream /POOLZ2/1SOs/ 
/POOL1/pfs/ISOs 


Mirroring from a Master PFS to a Slave PFS then to 
another Slave PFS 


You can do this to fulfill a scenario where you need 
replicated data both on premises as well as in 
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another continent. The replication between 
DragonFly systems can take place securely on the 
internet using SSH. To accomplish this, all the PFSes 
involved should have the same “shared-uuid”. 


Let us create three such PFSes in our system. One 
Master in POOL2 (already existing ) and two Slaves 
in POOL1. As mentioned earlier, the second slave 
could be on a DragonFly system in another continent 
connected through the Internet using SSH. 


dflyl# hammer pfs-status /POOL2/1ISOs | grep 


shared-uuid 


shared-uuld=0ael913£-92bb-11e7/7-944b-535400e58e 
BZ 


dflyl# hammer pfs-slave /POOL1/pfs/ISOsSlavel 

shared-uuid=0ael913f-92bb-11e7-944b-535400e58e 

52 

Creating PFS#1 succeeded! 

/POOL1/pfs/ISOsSlavel 
sync-beg-tid=0x0000000000000001 


sync-end-tid=0x0000000000000001 


shared-uuid=0ael913f-92bb-11e7-944b-535400e58e 
ay 


unique-uuld=0604dc83-95d2-lle7/-bf86-O0100000000 
O00 

label="" 

prune-min=00:00:00 

operating as a SLAVE 

Snapshots directory defaults to 


/var/hammer/<pfs> 


dflyl# hammer pfs-slave /POOL1/pfs/ISOsSlave2 
shared-uuid=O0ael913f£-92bb-11e7-944b-535400e58e 


OZ 

Creating PFS#3 succeeded! 

/POOL1/pfs/ISOsSlave2 
sync-beg-tid=0x0000000000000001 


sync-end-tid=0x0000000000000001 


shared-uuid=0ael913f-92bb-11e7-944b-535400e58e 
BZ 


unique-uuid=0e905044-95d2-1le7-bf86-0100000000 
O00 

label="" 

prune-min=00:00:00 

operating as a SLAVE 


Snapshots directory defaults to 
/var/hammer/<pfs> 


Configuring mirroring from POOL2 Master to First 


Slave in POOL1 


dflyl# nohup hammer mirror-stream /POOL2/I1SOs 
/POOL1/pfs/ISOsSlavel & 

Ee sa! 

dflyl# Prescan to break up bulk transfer 


Prescan 1 chunks, total O MBytes (729160) 


Gf Lyi pS. aus: ||) qrep mirror 

LOO L Ie Ore. “Oe 2 SOL Z 2297, i. AO 
8:18AM 0:00.01 hammer mirror-stream 
/POOL2/ISOs /POOL1/pfs/ISOsSlavel 


root TA82: Oi 0 “Ore 2: WZaOAsG ioe a. “SO 
8:18AM 0200.05 hammer mirror—sctream 
/POOL2/ISOs /POOL1/pfs/ISOsSlavel 

rOOL TAOS: We! Oi? JOZe Lose a “30 
8:18AM 0:00.03 hammer mirror-stream 


/POOL2/ISOs /POOL1/pfs/ISOsSlavel 


Checking Mirror Status 


du 
du 


dflyl# cd /POOL2/ISOs && 
/POOL1/pfs/ISOsSlavel && 
1749316 
1749316 
dflyl# cd /POOL2/ISOs && 
/POOL1/pfs/ISOsSlavel && 
2170047 
1749316 


&& sync && cd 


du 
du 


&& sync && cd 


Configuring Slave to Slave mirroring 


Now that we have some data in the slave PFS 
/POOL1/pfs/ISOsSlave1, we can start mirroring 
from it to the second slave 
/POOL1/pfs/ISOsSlavez2. This is important because 
we will not be able to access a slave PFS until it has 
completed the first mirroring operation with it as the 
target (its root directory will not exist until then). 


dflyl# nohup hammer mirror-stream 
/POOL1/pfs/ISOsSlavel/ /POOL1/pfs/ISOsSlave2 & 
pe eked. 

dflyl# Prescan to break up bulk transfer 


dflyl# ps aux | grep ISOsSlave2 

root Oil “OO: 20r2 S02 2304 1 £4310 
153 AM 0:00.00 hammer mirror-stream 
/POOL1/pfs/ISOsSlavel/ /POOL1/pfs/ISOsSlavez2 
LOO L 912 "OO! te “BOTT Ge6o° <:, jt 
ie 5 3AM 0:00.13 hammer mirror-stream 
/POOLL/pts/isOsslavel/y /POOL1l/pis/1sOsslaveZ 
FOOL Gis, ~O%0; Oa JOZS L096; as. <E0 
ie 5 3AM 0:00.01 hammer mirror-stream 
/POOL1/pfs/ISOsSlavel/ /POOL1/pfs/ISOsSlave2 
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915: De0: 1044 570 
0:00.00 grep ISOsSlave2 


S526: it 
(csh) 


LOOL DIV+ 


11:54AM 


Checking Mirror Status 


dflyl# cd /POOL1/pfs/ISOsSlavel && du -s && 
sync && cd /POOL1/pfs/ISOsSlave2 && du -s 


93 6 
1749316 


Removing a Volume from a HAMMER File System 


Now, we will remove a physical disk from the 
HAMMER file system named POOL1. It is not 
possible to remove the root-volume as it contains 
filesystem metadata such as HAMMER's layer1 
blockmap and UNDO/REDO FIFO. This command 
may also reblock the filesystem before it attempts to 
remove the volume if any data exists on the volume, 
and the volume is not empty. 


dflyl# hammer info /POOL1 


Volume identification 


Label POOL | 
No. Volumes 2 
HAMMER Volumes 
/dev/da0s0:/dev/dals0 
Root Volume /dev/da0s0 
PoLD 
e596db85-92ad-1le/-944b-535400e58e52 
HAMMER Version 7 
Big-block 2ntormatton 
Total ZOD I0O 1 
Used 2357 40.92%) 
Reserved Zoe Oke Oa) 
Free 253487 (99.07%) 
Space information 
No. Inodes 20534 
Total size AOL ZITA O36 7965106 
bytes) 
Used L6G: *(O8923) 
Reserved 184M (0.01%) 
Free 1.9T (99.07%) 
PFO 2nrOrmarion 
PES# Mode Snaps 
Q MASTER 0: {4OOt. PFS) 
1 SLAVE 0 
Z, ‘SLAVE 0 
3. SLAVE 0 


dflyl# hammer volume-del /dev/dalsO /POOLI1 
/dev/da0s0 


dflyl# hammer volume-list /POOL1 
/dev/da0s0 


You can make the changes permanent by editing the 
following line in /etc/fstab to: 


# Our POOLs 
/dev/da0s0 /POOL1 
CW dL 1 


hammer 


Configuring Off Site Mirroring 


Let us say a first Master PFS /POOL1/Data1 is on a 
server with IP address 111.111.111.111 


And a first Slave PFS /POOL2/Data2 is on a Server 
with IP address 222.222.222.222 located on another 


floor of the same building as the server with the 
Master PFS. 


Moreover, a second Slave PFS /POOL3/Data3 is on 
a Server with IP address 333.333.333.333 situated in 
another continent. 


Mirroring from Master 111.111.111.111 to first Slave 
222.222.222.222 can be continued even after a 
reboot using the following Cron entry in 
144.177.111.111 


@reboot hammer mirror-stream /POOL1/Datal 
TOOCEZ2Z2.222.22242227) POOLZ/ Daca 


Mirroring from first Slave 222.222.222.222 to second 
Slave 333.333.333.333 can be continued even after 
a reboot using the following Cron entry in 
222.222.222.222 


@reboot hammer mirror-stream /POOL2/Data2 
POOLE 3 354335455354.9357/ POOL3/ Daca 


Mirroring from a Slave reduces load on the Master 
and provides more throughput for the Master for 
writes & reads. For this to work, the SSH key based 
login for root user should be enabled on the Servers. 


Characteristics of Physical Devices that can be 
added to a HAMMER master file system 


It is possible to add IDE, SAS, SATA, and SCSI 
drives to the same pool or HAMMER master file 
system as long as the Operating System sees them 
as block devices. The devices are concatenated and 
remain unused until the previous block device is 
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filled up. Therefore, the read/write speed will depend 
on the specific block device that is in use. 
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ee ee 
AND TROUBLESHOOTING 





In this workshop you will see real life situations, where debugging skills will save you time, headaches and possibly 
find a solution with minimal amount of effort. 


Debugging/Troubleshooting is a really useful skill when you are working in maintaining legacy applications, doing 
some small incremental changes to an old code base, where the code has been touched by so many hands over the 


years and it is becoming really a mess. So, management has decided that the code works as it is and you are not 


allowed to change it all over “the right way ™”. 





FREEBSD 


Transparent Flow Mapping for NEAT 


The NEAT library provides application developers several data paths to a single transport connection 
with a unified and platform independent API for has become a key technology for many of these 
network communication, regardless of the underlying protocols. Adobe’s Secure Real-Time Media Flow 
network protocol. NEAT’s abstraction layer approach Protocol (RTMFP) [1], Google’s Quick UDP Internet 
allows the integration of new network protocols and Connections (QUIC) [2] and Web Real-Time 
transport features, transparently to the user. With Communication Data Channel (WebRTC) [3] are 
QUIC, RTMFP and WebRTC, several widely some examples for widely used protocols and 
deployed protocols make use of mapping multiple protocol stacks using multiplexing. Especially for 
data streams to a single transport connection. delay-sensitive applications with a low transmission 
However, the usage of multiplexing requires rate, multiplexing can be very beneficial. The inherent 
application developers to spend additional effort and transport protocol mechanisms, like flow-control and 
has to be supported by both endpoints. This paper congestion-control, improve their effectiveness when 
describes an approach to integrate multiplexing larger quantities of data have to be transmitted. In 
functionality into the NEAT library, giving application case of packet loss, a higher packet rate per flow will 
developers a simple way to use the benefits of result in faster retransmissions and less 
mapping multiple data streams to a single transport application-to-application delay. Also, sharing a 
connection without additional coding effort. We common congestion window (cwnd) is beneficial for 
describe our considerations about feature newly created connections or connections with a low 
negotiation, connection handling and data sending rate. Additionally, the reduced amount of 
transmission for multiplexed data streams, an parallel connections improves the capacity of 
introduction to the NEAT library, the implementation servers. 
details as well as measurement results and future 
steps. Having the choice between several network protocols 
with specific characteristics give application 
Introduction developers the ability to use the best matching 
solution for their use case, but also causes new 
The internet is dominated by two transport protocols, difficulties. Every protocol, regardless of whether 
TCP and UDP, supported by nearly every operating accessed via the operating systems socket API or by 
system and network. However, within the last years, a third party library on application level, requires a 
several new transport protocols have been different API usage. 
developed to better address the needs of modern 
network communication, providing new features and The NEAT library [4] addresses this issue by offering 
improved techniques. Many of these protocols are a unified and cross-platform API for network 
developed on top of the existing TCP / UDP stack communication. This includes not only transport 
provided by the operating system, increasing the protocols offered by the underlying operating system, 
compatibility with existing networks. By deploying like TCP, UDP or Stream Control Transmission 
them in user space, shorter software update cycles Protocol (SCTP), but also network protocols which 
can be realized. The usage of multiplexing to bundle operate at application level. For example, on 


of 


platforms without native support for the SCTP 
protocol, like macOS and NetBSD, NEAT can 
seamlessly include an SCTP userland 
implementation [5]. 


Multiplexing has to be implemented at application 
level on top of the network stack of the operating 
system, requiring additional coding effort. The 
developer either has to implement it from scratch or 
use an existing library providing an application level 
protocol which includes this feature. Especially when 
the application has only limited Knowledge of its 
peer’s multiplexing capabilities, a fallback solution is 
required to guarantee a successful communication. 
Even if the effort for multiplexing is high and its usage 
is not beneficial for all traffic patterns, previous 
investigations [6] have shown that the advantages 
outweigh the disadvantages for many use-cases. 


Our work introduces a multi-purpose multiplexing 
solution for the NEAT library, providing application 
developers with the benefits of multiplexing without 
additional effort. This includes an automatic 
negotiation mechanism which ensures a maximum of 
compatibility and transparency to the application. 
After introducing the NEAT library, its concept of 
flows and how they map to transport connections, we 
will explain the concept and implementation of 
transparently mapping multiple flows to a single 
SCTP transport connection without prior knowledge 
about the peer’s capabilities. The section is followed 
by some of our measurement results, considerations 
about alternative transport protocols and an outlook 
for our ongoing and future work. 


NEAT Library 


The NEAT library offers application developers a new 
interface for network communication. Instead of using 
the traditional socket API, which requires a lot of 
protocol and platform specific coding effort, NEAT 
provides a unified cross-platform API for network 
communication. This includes DNS-name resolution, 
connection handling, buffer management and 
encryption. NEAT is built on top of the libuv [7] 
event-loop library, and, therefore, it offers a 
non-blocking and callback-based API. Additionally to 
the functionality provided by the NEAT library, the 
developer has full access to the libuv library’s 


functionality. A detailed insight about the concept and 
architecture of NEAT has been given in [8]. 


Instead of specifying a transport protocol, the 
developer specifies his requirements for the 
properties provided by the transport service for every 
path. These requirements are for example 
ordered/unordered delivery, message preservation or 
reliability. Taking the preferences and requirements of 
the application into account, the NEAT library 
chooses the best matching protocol at run-time and 
cares for the protocol specific connection handling. In 
addition to the widely used TCP and UDP protocols, 
NEAT supports the SCTP protocol, the native SCTP 
implementations on FreeBSD and Linux, as well as 
the SCTP userland implementation on platforms not 
having a native support for SCTP, such as macOS 
and NetBSD. 


NEAT Flows 


In NEAT, a communication channel between two 
application endpoints Is called flow. Flows offer 
applications a bi-directional data transmission 
interface to the network. 


rv FF 


Figure 1. NEAT message and function sequence example 
using TCP 


In order to create a new flow, the client application 
provides a DNS-name or IP-address and the 
port-number of the remote endpoint and an optional 
set of properties. These properties offer a flexible 
way of configuring the requirements for the new flow, 
allowing a high level transport feature requirements 
specification. This includes demanding a reliable data 
transport and message preserving boundaries, as 
well as a lower level approach by setting the 
transport protocol(s) or protocol features, like SCTP’s 
multihoming, and encryption. There is a distinction 
between required and optional flow properties. For 
example, an application may require the SCTP 
protocol for a flow and optionally enable SCTP’s 
multihoming feature. Flows are assigned to flow 
groups where they have a specific priority within the 
group, affecting the share of the available bandwidth. 
If not specified, all flows are assigned to flow zero. 


Based on this information and collected data from 
previous connections, available address-protocol 
candidates are built, and the NEAT library tries to 
establish a connection, based on the flow specific 
properties. 


lf multiple address-protocol candidates are available, 
NEAT probes all available candidates by using the 
Happy-Eyeballs algorithm [9]. In case of several 
successfully established connections, NEAT will 
select the best matching connection and close all 
spare connections. This selection is based on the 
flows properties, taking the transport protocol specific 
characteristics and user specified priorities into 
account. For example, the TCP connection setup 
takes less round-trips than the SCTP connection 
setup. If the NEAT library probes TCP and SCTP 
candidates, the TCP connection will probably be 
established before the SCTP connection. To 
overcome this disadvantage for SCTP, NEAT will wait 
for an additional period of time before evaluating the 
results. When a connection for a candidate has 
successfully been established, the NEAT flow 
changes its state from connecting to open, and the 
application will be notified by means of the 
on_connected callback. Figure 1 illustrates the usage 
and operation of a NEAT flow using the TCP protocol. 


When NEAT uses the stream-based TCP transport 
protocol, the flow is reported ready for data 
transmission to the application by calling the 
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on_connected callback, right after the network socket 
becomes writable, followed by calling the on_writable 
callback. The application may now send and receive 
data via the flow’s data transmission functions. Due 
to NEAT’s non-blocking-io constraint, applications 
can write data to connected flows at any time. The 
NEAT library will try to send the data directly to the 
network. However, if the socket is not writable or the 
amount of data cannot be sent at once, the unsent 
data is buffered in a dedicated flow buffer. The data 
will be sent as soon as the underlying network socket 
becomes writable again. When all data has been 
transmitted to the network and no outstanding data is 
left in the outgoing flow buffer, NEAT will notify the 
application by calling the on_all_ written callback. This 
callback allows applications to saturate a network 
connection without bloating the outgoing flow buffer. 


When the flow’s network socket becomes readable, 
the NEAT layer notifies the application by triggering 
the on_readable callback. The application can now 
read data from the flow by using the neat_read 
function and by providing a read buffer with a given 
size. If the amount of received data exceeds the 
provided buffer size, the on_readable callback will be 
triggered again until all received data has been 
handed over to the application. Internally, the 
application reads directly from the flow’s underlying 
network socket without additional buffering by NEAT. 
Applications may close a NEAT flow at any time by 
calling neat_close or initiate a graceful connection 
shutdown by using neat_shutdown. The library will 
transmit all outstanding data to the remote peer, 
handle the connection closing procedure and trigger 
the on_close callback when all operations have been 
finished. After the on_close callback has been 
triggered, no flow specific callbacks will be triggered 
by the library and subsequent calls to read- or 
write-functions on the flow will result in an error. 


~ 
a a 


Figure 2. NEAT message and function sequence example 
using SCTP 


The usage of message oriented protocols like SCTP 
or UDP within NEAT differs internally from 
stream-based protocols like TCP, but operates 
transparently to the application. Figure 2 illustrates 
the usage and operation of a NEAT flow using the 
SCTP protocol. Once a SCTP based transport 
connection is established, NEAT will evaluate SCTP 
specific connection parameters and extensions 
before announcing the flow’s open state to the 
application. The parameters and supported 
extensions are important for the further usage of the 
flow. They include the amount of available SCTP 
streams and support of explicit end of record (EOR) 
marking, which allows the transmission of arbitrary 
large user messages by the application. Once all 
SCTP notifications have been read, NEAT will trigger 
the on_connected callback to notify the application 
that the flow is ready for data transmission. When the 
application writes data to the flow, it will be sent to 
the network or buffered within a flow specific send 
buffer, similar to TCP, as explained before. In contrast 
to stream based protocols, NEAT buffers unsent data 
in a message preserving way by using a message 
queue. Every user message is buffered in a distinct 
entry within the queue. When incoming data is 
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available at the network socket, NEAT will read the 
incoming message into the flow specific receive 
buffer. If the message is a fragment of a larger user 
message, NEAT receives and reassembles all 
fragments before announcing the complete message 
to the application via the on_readable callback. NEAT 
will only buffer a single user message, no further 
messages are read from the socket until the buffered 
message has been read by the application, in order 
to avoid bloating the incoming buffer on the receiver 
side. Closing SCTP based flows is similar to the 
procedure of flows using TCP. NEAT, like SCTP, does 
not support TCP’s half-closed feature, in order to 
keep the promise of a unified API. 


Transparent Flow mapping 


Transparent flow mapping hooks into NEAT’s 
abstraction layer approach by multiplexing multiple 
NEAT flows to a single transport connection without 
additional actions of the application. If both endpoints 
support multiplexing and the applications have 
enabled the support for transparent mapping in their 
settings, NEAT will automatically use the transparent 
mapping. As shown in Figure 3, the flows still show 
up as they would when using a dedicated transport 
connection, providing the same API and functionality. 





Figure 3. NEAT flows - comparison of 1:1 and transparent 
flow mapping 


Requirements and Negotiation 


Before the transparent mapping can be used, both 
peers have to fulfill some requirements and negotiate 
the support of the feature. NEAT requires some 
SCTP specific extensions to be supported by the 


network stacks on both sides, including the support 
for Stream Reconfiguration [10]. The user may 
require a flow to preserve data message boundaries. 
In this case NEAT requires the support for the SCTP 
User Message Interleaving (I-DATA) [11] extension, 
in order to prevent a sender side head-of-line 
blocking. If the local requirements are fulfilled, NEAT 
has to negotiate the multiplexing capabilities with its 
peer. This is achieved by using SCTP’s adaptation 
layer indication. The NEAT specific adaptation layer 
indication value is exchanged within SCTP’s 
connection setup procedure and provided as an 
SCTP notification on both sides, once the connection 
has been established. If all requirements are met, the 
transport connection is marked as usable for 
transparent flow mapping. Otherwise the NEAT 
library continues operating in regular mode and maps 
every flow to a separate transport connection. This 
approach has the advantage of being fully 
interoperable with peers not using the NEAT library. 


Flow creation 


Creating a new flow triggers the NEAT library to 
search for an established SCTP association with a 
matching tuple of destination address, port, 
properties and support for transparent flow mapping. 
Only flows belonging to the same flow group are 
taken into this survey, allowing the application to 
prevent multistreaming for a flow by assigning it to an 
empty flow group. 


Figure 4. Transparently mapped flow creation procedure 


If NEAT discovers a matching SCTP association, the 
new flow is mapped to it instantly and all ongoing 
connection establishment procedures for other 
address-protocol-candidates are stopped. The 
mapping is realized by assigning the new flow to a 
dedicated SCTP stream of the established 


association. The amount of flows per transport 
connection Is limited by the number of available 
incoming and outgoing SC TP streams per 
association. SCTP itself supports up to 65535 
streams per association. As shown in Figure 4, the 
NEAT library will notify the application instantly by 
triggering the on_connected and on_writable 
callbacks. If multiple SCTP associations are available 
for a transparent mapping, NEAT takes the first one 
to bundle as many flows as possible. 


The first flow, for which the SCTP association has 
initially been created, will always use stream id zero. 
All additional flows are assigned to unused stream 
ids. To avoid a glare situation, occurring when both 
endpoints map new flows simultaneously, the peer 
which initiated the transport connection will use even 
stream numbers whereas the remote side will map its 
flows to odd stream numbers. Both sides maintain a 
status map of the assigned stream numbers. 


Due to the lack of a connection setup procedure on 
the network, the creation of a new flow is signalized 
to the remote side by sending the first data message. 
Transparently mapped flows are instantly ready for 
data transmission without additional round-trips and, 
superior to the TCP fast open mechanism [12], the 
amount of outgoing data is not limited. When 
receiving an SCTP message on a previously unused 
stream id, the receiver creates a new incoming flow 
and triggers the same callbacks as if a new 
connection using a native transport connection had 
been opened. Using an implicit flow setup restricts 
the usage of transparently mapped flows for use 
cases where the server starts transmitting data to the 
client without receiving a request, for example a 
daytime-server. A possible approach to overcome this 
limitation is the explicit connection setup by sending 
a control message with a specific Payload Protocol 
Identifier (PPID) to trigger the incoming flow 
procedure on the receiver side. 


Data transmission 


One of the most challenging parts of transparently 
mapped flows is the handling of incoming and 
outgoing data. Sharing a network socket between 
multiple flows requires the NEAT library to cope with 
scheduling and buffer management techniques. 
When a shared socket becomes writable, NEAT 


schedules over all assigned flows in a round-robin 
manner. Beginning with the first flow, the library 
transmits scheduled data from the outgoing flow 
buffer before triggering the flow’s on_ writable 
callback. When the flow neither has outstanding data 
in the buffer nor received new data from the 
application, the library will continue with the same 
procedure for the next flow. As mentioned in the 
negotiation section, applications may send arbitrary 
large messages and require message boundary 
preservation. To transmit user messages larger than 
the maximum segment size (MSS), SCTP supports 
fragmentation and reassembly. The sender 
fragments the user message in multiple DATA chunks 
for transmission which are reassembled by the 
receiver. If the sender starts transmitting a large user 
message, consisting of several data chunks, 
transmissions on all other streams are blocked until 
all fragments of the user message have been 
transmitted. To overcome this sender side 
head-of-line-blocking when transmitting large user 
messages, NEAT uses the SCTP I-DATA extension. 
I-DATA solves the sender side head-of-line-blocking 
issue by supporting message interleaving [11] and is 
also used in the WebRTC protocol for the same 
purpose [3]. Another major change for multistreaming 
affects the receiver side. Whereas a one-to-one style 
mapped flow only buffers a single incoming user 
message, a socket used for multistreaming reads 
messages from the underlying SCTP socket until all 
assigned flows have at least one user message in 
their receive buffer. If the sender transmits data on 
two or more flows and the receiver does not read 
data from one particular flow, NEAT buffers this data 
to prevent other multistreamed flows from being 
blocked by this flow. Limiting the maximum amount of 
buffered data on the receiver side would either result 
in dropping data for the particular flow or in blocking 
all incoming messages for every transparently 
mapped flow on the affected SCTP socket, both 
cases are undesirable. A possible approach to 
overcome this limitation would be application based 
flow control per transparently mapped flow. Here the 
receiver signalizes the increasing flow buffer by 
sending a specific control message to the sender to 
prevent further transmissions on this particular SCTP 
stream. 


Teardown 
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Analogous to the creation of a transparently mapped 
flow, NEAT cannot make use of SCTP’s native 
closing procedure for teardown. Instead, NEAT uses 
the SCTP Stream Reconfiguration extension for the 
closing procedure. When the application calls the 
neat_shutdown function for a flow to initiate a 
graceful shutdown, all outstanding data will be sent 
and the application may still receive data from its 
peer, shown in Figure 5. Internally, the flow is marked 
as closing by the library and once the outgoing flow 
buffer has been drained, NEAT will trigger the SCTP 
stream reset procedure for the outgoing stream. After 
calling the neat_shutdown method, the application 
cannot write any additional data to the flow, the 
on_writable event will not be triggered any more and 
calling neat_write will cause an error. 


Figure 5. Transparently mapped flow shutdown 
procedure 


Upon receiving an SCTP Stream Request for an 
incoming stream, NEAT indicates the event by a 
return value of null when the application calls the 
neat_read function. The flow will not accept new data 
via the neat_write function for transmission. When 
the remote endpoint also responds with a Stream 
Reset Request for the incoming stream, the closing 
procedure of the flow has finished and all resources 
may be freed. This behavior reflects the connection 
teardown process for unmapped flows. An application 
may also use the neat_close function. In contrast to 
neat_shutdown the closing procedure resets the 
outgoing as well as the incoming SCTP streams. 
Once the closing procedure for a flow has been 
finished, the SCTP stream id may be reassigned to a 
new multistreamed flow. Both endpoints maintain an 
SCTP association assigned status map for every 
stream id. 


Measurements 
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Figure 6. NEAT flow mapping - 1:1 mapping and 
transparent flow mapping 


To examine the advantages and disadvantages of a 
transparent mapping, we used a client-router-server 
scenario. All machines are physical nodes running 
FreeBSD 12 with a GENERIC-NODEBUG kernel. As 
shown in Figure 6, the NEAT Client and the NEAT 
server are connected via the router which emulates 
various network conditions between the two peers by 
using FreeBSD’s builtin dummynet [13] network 
emulation tool. The router emulates different network 
conditions by adding delay and packet loss to the 
path between the server and the client. To achieve 
some randomness during the measurements, the 
client transmits a low amount of random UDP 
messages to the server. Our benchmarking tool, 
using the NEAT library, is designed to measure a 
variety of parameters, including the 
application-to-application-delay between both 
applications for every flow. 


The scenario compares the impact of packet loss and 
link delay for mapped and unmapped streams 
concerning application-to-application delay. The 
NEAT Client opens two SCTP based flows to the 
NEAT Server and sends small messages between 
100-200 bytes periodically with a low rate on each 
flow to simulate an application using multiple flows 
for data transmission. This behavior is typical for 
many use-cases like a browser scheduling requests 
over multiple connections or control systems 
reporting data to a central instance. 
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Figure 7. Measurement results comparison of mapped 
and unmapped flows 


We varied the link delay, starting with 10 milliseconds 
in steps of 10 milliseconds to a delay of 50 
milliseconds and used loss rates of zero, one and 
two percent on the link. Every measurement ran for 
60 seconds and was repeated ten times. As shown in 
Figure /, the results show a slightly higher 
application delay for multiplexed flows on 
connections without loss, resulting from internal data 
handling within the NEAT library. In case of packet 
loss, the transparently mapped flows show a lower 
delay compared to regular flows. This is a result of 
better utilizing the transport protocols loss detection 
algorithms. 


Our results show a significant 
application-to-application delay improvement for 
transparently mapped flows in comparison to regular 
flows, fulfilling our expectations. 


Alternative transport protocol considerations 


As mentioned in the previous sections, transparent 
flow mapping is not tied to the SCTP protocol. In 
addition to the SCTP protocol, Google’s QUIC 
protocol also covers many requirements for the 
transparent mapping of multiple flows and, since it is 
layered on top of UDP, it can seamlessly be 
integrated into NEAT’s abstraction layer approach. 
Mainly developed to replace TCP as the underlying 
transport protocol for HT TP2, QUIC is not tied to this 
use-case and may be used by any other application 
for generic purposes. Similar to SCTP, QUIC uses 


multiplexed streams and does not suffer from 
head-of-line blocking. In contrast to SC TP, QUIC 
supports zero-RTT connection setup and uses 
encryption by default. Due to QUIC’s early stage of 
development and the lack of a specification, QUIC is 
a candidate for future work. Another candidate is 
Adobe’s RTMFP protocol which is also UDP based 
and multiplexes multiple flows over a single transport 
connection. Although specified in by an RFC [1], no 
official RTMFP library is available and the 
development has been discontinued. 


Conclusion and outlook 


While multiplexing of several data streams ona 
single transport connection has become a feature 
more and more popular due to its usage within new 
protocols, it still requires additional effort for 
application developers. Especially when the 
application has no knowledge about its peer. Even if 
the developer uses a userland implementation of a 
transport protocol that supports multiplexing, it still 
remains an additional coding effort, especially when 
a fallback solution is desired. With NEAT’s approach 
of creating an abstraction layer on top of the different 
network protocol APIs to give developers a unified 
way of accessing transport function. We were able to 
seamlessly integrate a transparent flow mapping 
feature which gives application developers the 
benefit of multiplexing without additional coding 
effort and still being fully compatible. We introduced 
our approach for multiplexing using SCTP., the 
integration in the NEAT library and the techniques for 
feature negotiation, flow handling and data 
transmission. Our measurements show advantages 
of transparently mapped flows over regular flows in 
usual use-cases. In our Ongoing work, we are 
focusing on improving the buffer management and 
scheduling of concurrent multiplexed flows. 
Additionally, we will add support for WebRTC 
Data-Channels [3] to the NEAT library. This allows 
developers to use NEAT not only for client-server 
communication but also for building peer-to-peer 
applications. 
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UNIX 


Advanced Unix Queuing Techniques 


Following on from the discussion of some of the 
types of queuing mechanisms, available on Unix, it 
may be beneficial to examine the design of a queuing 
system, loosely modeled on that used by IBM, in its 
WebSphere MQ Series. 


The MQ paradigm is based on the concept of a 
Queue Manager, which controls a set of local 
queues, which are grouped into Channels, which 
latter are of the ‘send’ or ‘receive’ variety. These 
queues are disk based files, each located under a 
directory which bears the name of the queue. 
Normally, there will be several inbound and 
outbound queues combined into a receiving or 
sending Channel, respectively. Each Channel has 
associated with it an IP address of the remote 
machine. In operation, each queue manager 
performs as a simple TCP/IP server, and listens for 
connections on its separate port, whose number is 
around 1414. Connections arrive from other 
machines and, in the traditional manner, the server 
forks to service each connection, transferring 
double-byte data from the socket to the disk. 
Although this, in essence, appears to be a classic 
client-server system, the connections are, actually, 
from server to server, or queue manager to queue 
manager. Most of the queue manager’s time is spent 
listening for incoming connections, and polling its 
local outgoing queue directory, waiting for some 
local application to place data on a queue. 


When this happens, the local queue manager forks 
and makes a connection to the remote machine, 
whose IP address and port number are available 
from the channel definition. While the child process 
is transferring data, the parent continues to check 
the directory and listen to port 1414. 


lt may be instructive to follow this sequence through. 


° Machines A and B both listen on port 1414. 


3/ 


; Machine A’s queue manager is informed that 
an application has placed a message on the ‘send’ 
queue. 


° The queue manager forks a child process, 
which makes a socket connection to machine B, on 
port 1414. 


° Machine B’s queue manager accepts the 
connection, and forks a child, to handle the 
connection. The child uses port 32/768. 


° Data is transferred, from A to B. 


Note that there is no conflict in terms of the port 
number since both managers fork child processes, 
which use dup’d ports. 


Unix Shared Memory-Based Queue Functions 


There are only four system calls associated with 
memory-based queuing functions: 


msgget() — which creates or identifies queues, but 
does not get messages. 


msgsend() — which sends a message to a queue. 
msgrecv() — which fetches messages from a queue. 


msgctl() — which either interrogates or deletes the 
queue. 


We create a queue like this: 
int qd, qe; 


if((qd = 
IPC CREAT|0777) ) 


mSsgger( IPC. PRIVATE, 
ay 4 


perror(“mseqdet”); 


The IPC_PRIVATE parameter has the same 
significance as it creates shared memory segments, 
and can be any unique identifier contained in an int — 
or ‘key_t’ since it is defined in the header. The 
IPC_CREATE | 777 flags are identical to those used 
with the open() system call for creating files, and 
have the same meaning. The return value, qd, looks 
and works like a file descriptor. It is the queue 
identifier which we will use when accessing this 
queue. Now that we have an identifier, we can read 
from and write to the queue but first, we need to 
define a queue element structure. 


As with other Unix queues, this structure has to look 
like this: 


struct { 

long yp; 

char txt.| Length |; 
} MSo; 


Meaning that, when it is lying about in the memory, 
or in flight down a TCP/IP connection, it looks like a 
packet with a four-byte header and a ‘length’ byte 
payload. 


More importantly, the queue functions expect to read 
a piece of contiguous memory, which conforms to 
this definition. 


The significance of this is that, we cannot 
dynamically allocate the memory for the ‘txt’ 
member since this would make our message look 
like an int, followed by a pointer. At best, we would 
enqueue or dequeue 8 bytes and at worst, we would 
get a segmentation error. 


As usual, there is a work-around for this apparent 
limitation. 


Basically, we don’t define a structure at all, but 
concentrate on the packet concept. 


lf we declare a pointer to unsigned char, 
UNS2OnNeC. char *xsg; 


then, we can send any type of data, and of any 
length. The only thing we need to remember is 
always to allocate 4 bytes more memory than we 
need, and to commence writing our four bytes data 
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past the starting address of our allocated memory. 
By way of an example, let us assume that we wish to 
enqueue an array of double-byte characters, which 
look like int’s on a Solaris system and shorts on 
most other Unix systems. 


wehar © “wehars [255]; 


For convenience, we would rather declare a dummy 
pointer to an int so that we can fool the system into 
letting us add our ‘type’ member to the first 4 bytes 
of our unsigned char array. The ‘type’ member 
contains an arbitrary, user-defined integer, which we 
can use later to identify our message in the queue. 


Lie “Sa 


Now, we can send the array to a queue. However, 
we first need to allocate memory: 


1f((xsg = (char *)malloc(sizeof(wchars) +4) ) 


== NULL) { 
printf(“Memory allocation error\n”); 
} 


Take note of how we ask for an extra 4 bytes to cater 
for our ‘type’ member. 


Next, we set our pointer to the first location in the 

array: 
Kine = {ine *)exsq/'0|4 

Next, we can insert our integer: 
xin [0] <= 9s 


and load the newly-acquired memory with our 
wide-character data: 


memcpy ((char *)&xsg[4], (char 


*)wchars), sizeof(wchars)); 
Finally, we send it to the message queue: 


if (msgsnd (qd, 
OO) a 


(void *)xsg, sizeof(numbers), 


Perron (mq Send) 7 


The syntax for msgsnd() is fairly obvious, and follows 
the pattern of write() to a file, or that of send() to a 
socket. The first argument is our queue descriptor, 
the second is a pointer to the data, and the third is 
its length. Finally, we have the flag which defines 
what to do with the message if the queue either 
contains the maximum number of bytes, or the 
maximum number of messages: 


° lf the flag is IPC_NOWAIT, the call returns 
immediately and the message is not sent. 


: lf the flag is zero, msgsnd() will hang until the 
queue is no longer full, or the queue gets deleted, or 
the current process catches an interrupt. 


For our purposes, a flag of zero makes for more 
reliable delivery. So, that is what we use. 


Now for the receiving function, msgrcv(). 


The syntax is, as with msgsnd(), similar to the read() 
and recv() system calls. 


Given a receive buffer definition similar to 
unsigned char data[8192]; 

and type and flag parameters defined as 
Int, typ, flg; 

We can see how familiar the code is: 


(vold *) &data, 
=) 


Et Amso rev (gd, 
typ, flg)) 


sizeof (data), 


N ul . 
7 
perror( msarcy’ ) 


The msgctl() system call returns information about 
the queue. 


The syntax Is: 


msgcul (queue, thag,: Structure. poiInver):; 


where, the flag is either IPC_STAT, for retrieving data, 
or IPC_SET, for altering queue characteristics. 


In practical terms, the only items we can alter are the 
permissions on the queue, unless we run as root, 
when we can change the maximum queue size. 
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Accordingly, information retrieval is this function’s 
greatest value. The structure_pointer mentioned 
above points to the msqid_ds structure, defined in 
sys/msg.h as: 


SUVUCE: msgrd Os: x 


SEEUCE pC perm. msg perm, f% 
operation permission struct */ 
Struct. msg ‘MSO: LLrstu; 
c* Dir oO: Birsc message on <q */ 
SELUCE msg “nso. dias iy 
/* ptr to last message on q */ 
MsSGLen. Msg Cbhytes; 
j* current. # bytes. on sq *7 
msgqnum t msg gqnum; is 


# of messages on g * 


MSGenk ic msg Gbytes; 
/* max # of bytes on gq */ 

pid. t Neo 1Ssoid; 
/* pLa-ot. Last msqsnd- */ 

pid. c meG.1rpad; 
/* pra Ob last msqrev */ 

time t msg Suime; 
/* last msgsnd time */ 

LE aMee Msg Fe Mey 
/* last msgrcv time */ 

Gelie. 7e Msg Ceime; 
/* last change time */ 

short MSG CV; 
[-*. TOE: SEG: 

Shorr msg qnum cv; 
(FMS SSC. Ay 


ie 


whose members are filled in by the system call. 
Putting it all together gives us a typical call as: 


SLELUCE. MSO1dds' iar; 


LE (MSsGcelilgd;. LPC USTAT,: seu): == Si)4 


PELErOR( NSgGCEL “ota server <\4 


} 


from which, we can get useful information, such as: 


printf (“Current queue length: %d\n”, 


ace Ms 9 --Qaum) 
Implementing Some MQ Functionality 


The MQ model is very efficient in terms of use of 
machine resources. The functionality is soread over 
many processes, and is a good example of a 


Multi-Dimensional Architecture. However, since MQ 
needs to use persistent queues, it throws away all of 
its performance advantages, by doing very heavy 
disk I/O. This is largely irrelevant for short messages 
but, if it is used for performing large data extracts, 


from large databases, the delays become significant. 


For the sake of this exercise, we will assume that, 
the speed of operation is of paramount importance. 
However, the normal reliability of delivery is 
adequate and a machine crash is tolerable. 
Accordingly, we will design and partially code a 
simple queue manager which implements most of 
the functionality of the MQ manager, but uses kernel 
queues. The implementation of any refinements is 
left, as they say, to the reader. 


The Queue Manager 


First, let us remind ourselves of the two prime 
functions of our queue manager: 


: Listen for incoming connections 


° Check local queues for data needing 
transmission to remote sites 


There are two possible solutions to this apparent 
dichotomy 


° Run two processes, one possibly being the 
child of the other. 


° Run one process, within which we have two 
threads of execution. 


Since MQ series was born at a time (and ona 
machine) where pthreads weren’t even a glimmer on 
the horizon, IBM uses multiple processes. 


From a performance perspective, this would 
represent the best practice for us, too. But first, let 
us specify, in detail, what happens. 


lf our server is sitting there, with its ear glued to port 
1415, then how is it going to transmit data through 
that port? The answer is that it isn’t. 


What happens is that, whatever checks the local 
queues and decides to send the messages to the far 
corners of the earth, will make a connection to port 
1414, in the same way as the server on the far side 
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of the moon, with a message for us. This means that 
our server only has to differentiate between an 
inbound and an outbound connection and take the 
appropriate action. Once the connection Is 
established, and the server has forked a child, the 
child will have its brand-new socket, a port number, 
and can send or receive data at will. The sequence 
of events in our server is now looks like this: 


: Listen to port 1414 


: lf the incoming connection is local, it is 
outbound. 


; Fork process for reading messages from 
queues 


° Inside this process, send outbound queue 
data to remote address 


° Child terminates 


: If the incoming connection is remote, it is 
inbound data. 


° Fork process for enqueuing messages 
° Inside this process, enqueue incoming 
messages 

° Child terminates. 


Now, we nearly have a complete picture. However, 
we are pretending that we only have one queue 
manager and a pair of queues at each end. In reality, 
we could have many, going to many destinations. 
Also, following the MQ policy of ‘guaranteed 
delivery’, we would need to re-send any messages 
which failed on the first attempt. 


What about the User Application? 


The whole purpose of a queuing system is to make 
data flow from one place to another. So, how does 
the user application fit in? In an MQ environment, the 
application is always written such that it; 


° Calls CONNECT to connect to a queue 
manager. 


° Makes a request to GET inbound messages or 
PUT outbound messages 


: Does its thing. 


° Quits. 


Note that, given the above scenario, it is evident that 
the application doesn’t need to directly execute the 
queuing system calls. The CONNECT() function, 
from the MQ library, hides the mechanics of the 
TCP/IP connection to the queue manager, and the 
GET() or PUT() function calls merely pass the data 
down the socket connection, for the queue manager 
to enqueue or dequeue. 


The Channel Manager 


Everything seems to be automatic. Do we need a 
Channel Manager? 


It is the responsibility of the application to remove 
inbound messages, and the responsibility of the 
Queue manager to forward outbound messages. This 
means that, for inbound messages: 


: Server handles connection from remote site. 
: server enqueues inbound message. 
; Server waits for the application to connect 


with a GET request. 
For outbound messages: 


: Server handles connection from application, 
with a PUT request. 


: server enqueues message. 
: server forwards the message to the remote 
site. 


lt may be seen that, inbound messages are event 
driven and need no external agent. Outbound 
messages are enqueued, and then forwarded 
immediately by the child process which enqueued 
them. Accordingly, unless there is a communications 
failure, we may assume that the queue manager 
server will itself, immediately, empty the outbound 
queue. It is this latter condition which necessitates 
the use of a channel manager. 


Each channel manager will be associated with a 
Queue manager, and both will be handling traffic to 
and from a given destination, (the ‘channel’). When 
the channel manager sees a message count of some 
number more than zero, it connects to Its 
appropriate queue manager, on the appropriate port 
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number, to tell it that the queue needs servicing, and 
the IP address where the data should be sent. 


lts operation would follow this pattern: 
Check the length of the outbound queue. 


° If it is greater than zero, we need to send a 
message. 


° Connect to port 1414. 


: Give the queue manager server details of 
which queue, and where to send Itt. 


: Go to sleep for a predetermined period. 
The Protocol 


We will also need to design a primitive protocol, 
contained within the message header, so that the 
server can differentiate between an inbound and an 
outbound connection and for safety, can differentiate 
them from a spurious connection. Within the 
protocol, there has to be a slot for identifying the 
queue and the destination, if appropriate. 


While keeping within the constraints of the basic 
queue structure, we will add some fields to it to 
make it better suited for our purpose. 


We need the following information: 


: Type of operation — ‘GET’ or ‘PUT’, symbolized 
by ‘1’ or ‘0’, as 1 character. 


: Name of queue — 23 characters, although MQ 
permits 40. 

: Length of following message + length of an int. 
° Type — an integer, as defined in msg.h 

° Data 


Which gives us a 32-byte header, which fits on either 
a 4-byte or 8-byte boundary, such that TCP/IP will 
not perform any padding. 


We can deduce from all of the aforegoing that, 
multi-threading is not going to be of any use to us. 
We will have two families of processes, associated 
with the queue manager and channel manger, and it 


would be inefficient to attempt to run them as two } 
threads. Readers who disagree are invited to code a IX. we ee BORIS: Cae ae. 
threaded version and compare response times. 


memset (&sa, O, sizeof(struct 
sockaddr -1n):)'; 


Server Code | | 
if (gethostname (hname, sizeof(hname)) != 
Oo) 


since this is a test program, we will begin it by 

printf (“Can’t determine our own host 
creating one outbound and one inbound queue. names, “OULEtIngG \n” ):: 
Ordinarily, these will have been created earlier, and 
their descriptors saved, for passing to the queue 
manager. We will need the following definitions: 


quit(-1); 
} 
if((hp = gethostbyname (hname)) == NULL) { 


StCEUCT xXOCa Lat 
return(-1); 


Long: “iyo? /* O=l1st on queue, 
n=lst of type n, -n=l1st of <n */ } 

char msg[8192]; if((svce = getservbyname (“ingreslock”, 

“tcp”)) == NULL) { 
ba 
Pranti ("ss doesn’t -exist\n”); 
struct xgqdata qdata; /* Cate 
from msg queues */ quit (-1); 
} else { 

struct xmsg { pOrtcnum. =. Sve=>s. port? 

char mode; /* 1=GET O=PUT */ \ 

char qname[23]; printf(“Server on machine %s, listening to 


port S$d\n”, hname, portnum); 
int length; 
Sa.sin family = hp->h addrtype; 
struct xqdata mesg; 7 7 
SaeSin: pore = hbons (portnum ); 
be 
1f£((s = socket (AF INET, SOCK STREAM, 0O)) < 
struct xmsg *msg; OQ) { 7 7 


Uae) 


int. Gd, Ges /* outbound, inbound } 
queues */ 


ir (oli tS, “(Struce sockaddr ™) Gsa-, 
int. *x<ant= Si 2600 (Struce. sockaddr am) ) <0). 4 


char *xsq; Print ("Can Dine EG spore <a un; 
POrEnUumM) ; 


main () 
perror( band’ ) 7 


{ 


close(s); 


/* and we can now create our queues: */ 


Gude) 
/;* OaLbound queue: *y 
1£( (qd = msgget (IPC PRIVATE, 
TPC CREAT|0777)) == -1)T listen(s, 20); 
Déerror("msGgeLr” )= while (1) { 
} inlength = sizeof(sa); 
s, (struct sockaddr 


7* inbound. queue *7 Li (xs = oo 


( 
*)&sa, &inlength)) < 0){ 
1f( (qe = msgget(IPC PRIVATE, 
TPC CREAT Oh): aa = break; 


perror (“msgget”) ; ; else. 4 
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p = (char 
* Eee: Oa (Sa sim addr) > 


> oSk Vl» D)S 


EELS (St aowe) ? 


Swrech C(ppid =. fork()) ) 4 
/* make our child process */ 


case -l: 
perror(’LOrk”™) ; 
exit(-1); 

break; 

case 0: 


1f(setsid() == -1){ 


perror (“setsid”); 


printf(“\nIncoming connection from 


1 = 0; 
memset (buf, ‘\0O’, 
sizeof (buf) ); 
while((rval = recv(ds, 
Ditk, Sizeot (but). “O09 20) 
printf (“Server read 
CoO) SS eSe it. Evel, but) % 


pow 


* Concatenate until 


we have it all 


* data[] should be 
dynamically allocated! 
a 
memcpy (&data[1i], buf, 
rval); 
1 += Cva ls 
1£(1i >= 8192) break; 
rval = QO; 
memset (buf, ‘\0O’, 
sizeof (buf) ); 
} 
/* we only do ‘GET’ and 
MPT. 5p 
ie (date Lol. SS SOF ol] 
data[OQO] == ‘1’){ 
1f(readtoken(ds, data) 


printf (“Server 


$d:Done\n”, getpid()); 


1f (close (ds) 
Q) { 
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perror (“Server 


Close. Socket. error” ); 


} 


exit (0); 


Can: Gut; now *7 


} else { 


[-* Chia 


printf (“Server 


$d:Finished with errors\n”, 


getpid()); 


1f(close(ds) != 


oe 


perror (“Server 


close socket. error”); 


exit(-1); 


} 


} else { 


printf (“Server 


%d:Received corrupt message\n”, 


getpid()); 


break; 


default: 


printf (“Server 


S$d:Listening for next connection\n”, 


getpid()); 


Wwaitpid(ppid, 


break; 


} 


/* we've finished with the queues, 


delete them */ 
1f (msgctl (qd, IPC. RMID, NULL) 
perror(“msgctl RMID”); 

} 

TE(msgcti (ge, LPC. RMID, -NUGL) 


Perron “msgctl PMID); 


&status, OQ); 


let’s 


=) A 


ae Srey 


} readtoken(s, token) Co 
readtoken */ 


printf (“Server done\n”); 


Int: SF 


* * 
oe ere! hf UnSsugned. cher token; 


Additionally, we’re going to need some other 
functions, to do the housekeeping for us. 


First, the message parser: 


Ya aE aaa aa a p ae d io p al: d r 


KKKEKKKKKKKK : : ' ' 
CnsToned 20. -prLori cy; 


* Parse the message header, and extract the ene er 
message. The raw format is: int nwrite; 


msg + type 
=a SALES int length; 
int. 1 





* Which is defined as: 


* struct xmsg { prinwt (AnChild sérver PLD 2d. running nn’; 


getprd ().).7 
“char mode; -> ‘1’ = GET, ‘0’ = ‘PUT’ 
* — char qname|23]; mso = (SLrucl. xmsg *) token? 
* int length; 


r strcepy (name, msg->qname) ; 


unsigned char mesg[8192]; 


* 1. mode = msg->mode; 
* 

length &= 0x00; /* make a 
* Note that the ‘mesg’ member is what we actually number out of chars */ 


need to enqueue the MSQ, rval = 0x00 | token[24]; 


* 1 1 . 
and is in the format: elt = eal Ae os 
length |= rval; 
e ISUEUCE 4 


rval = 0x00 | token[25]; 


s int type; 
* char txt[8188]; rval = rval << 16; 
* } qdata; length |= rval; 


rval = 0x00 | token[26]; 
KAKKKKKKKKKKKKKE KKK KKKKKKKKKKKKKKKK IKKE KKK KK IKIKKHK 
Kk kK KK kK KK KK KK KK KK KK KK KK KK KK KK / rval = rval << 8; 


length |= rval; 
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length |= token[27]; 


queue >%s< mode >%c< 
length) ; 


printf (“Token data: 
length d\n”, name, mode, 


PO a. SS 255 a, RS eed ee ae 
DEINEE (coe; Voken| a) 
} 
Primer (on) e 
/* 
“ This is artificial, since we need to examine the 
channel 


* details, to find out which queue goes 


where 
ae 
1f(mode == ‘1’){ 

/* GET (De-queue) */ 

LE (Stremp (name, “MOL” )>. == °0) 4 
/* Inbound queue */ 

dequeue (qd, s); 
} 
else if (stremp(name, “MQ2”) == 0) { 


/* Outbound queue */ 


printf (“Doing GET from outbound 
queue\n”) ; 


dequeue (ge, Ss); 
j 
} else { 
/* PUT (Enqueue) */ 
if (strcmp (name, “MQ1”) == 0) { 


/* Inbound queue */ 


PELOEL Doing. PUL co tnbound 
queue\n”) ; 


enqueue (qd, length, &token[28]); 


} 


else if (stremp(name, “MQ2”) == 0) { 
/* Outbound queue */ 
enqueue (ge, length, &token[28]); 


} 


/* We now need to forward this message 
to the address at the other 


* end of this channel 


a 
forward(token, name); 


} 


eeturn(.0) 


} /*® readtoken. */ 


Now, here are the enqueuing and dequeuing 
FUNCELOMS, 


enqueue (qdd, length, token) -* 


enqueue */ 


int, Caer 
int length; 


unsigned char *token; 


unsigned char *xsg; 


SLIUCE. MSGI: Cs: abr; 
printf (“Server enqueuing messages...\n”); 


msgsnd(qdd, (void *)token, length, QO) 


if ( 
Se ek 


perror (“msgsnd”) ; 


memset ((char *)&atr, *\0’, sizeof(struct 
msg iG: -dS)).) 7 
LEMS oces (qe: LPC s1A,: ecr). S by 
perror("msgctl STAT server”); 
P MSS. 4 
LE Car smso.-GQnum- > 0) 4 
printf (“Placed td messages (%d 


LOtal. bytes) “On 1G: sd \n";. “alramso. Gqnum 


7. ACLeMS9.-ChYLes, “Gdd) 7 


} 
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enqueue */ 


oo ee tae Ss) /* dequeue 
* 


ie “CCCs 


Inte. s+ 


Struck x<mis¢o ndata; fs Gace = rom TCP iP 
* 


The, ay 

Int ~Vval; 
int nwrite; 
long typ = 0; /* get lst available msg */ 
int flg = 0; 


/* block until msg arrives */ 


SECUC MSgrd ds: acr; 


printf (“Client collecting messages from 
Gueve. 4.<\n jG 

memset ((char *)&qdata, ‘\0’, 
sizeof (qdata)); 


while((rval = 
sizeof (qdata), 


MSGorcv (gga, (vord-*)eqdata, 
EVP; 2Lo).) b= =) 


printf (“Server read *d bytes of type 
Sd queue %d data:\n”, 


LVale Gdavactyp,;. -CqGdy¢ 
sprintf (ndata.qname, “MQ%d”, qaqd) ; 
ndata.length = rval; 
ndata.mode = QO; 
ndata.mesg.typ = 9; 
memcpy (ndata.mesg.msg, qdata.msg, 
rVeL) ? 


for(i = O; i < rval; itt) { 


Wy 


PLING ".e") Gdaravmse 4:7 


} 


Prine r( Aa) 


EE trval > Oj 4 
noting “= 


-* MO POLne. wri teng 


1f((nwrite = send(s, (void *)&ndata, rval, O)) 
< Pryval) 4 
perror(“Server: write to 
SOCKeEL™ )'\> 
free (xsg); 
return (-1); 
} else { 
printf (“Server sd: sent %d 
byte msGgr to: -clment ni, 
getpid(), nwrite); 
} 
} else { 
printf (“Strange: zero-length 
message on queue...\n”); 
} 
memset ((char *)&qdata, ‘\0’, 
sizeof (qdata)); 
memset ((char *)&ndata, *\0’, 
sizeof (ndata) ); 
memset((char *)&atr, *\0’, 
SiLAZSCOE CSE rUCu. MS ore. ds) )% 
MEAMSOCE LQG. EPC SPAM, «ae fal) y 
i (ac miso qnum.: == :0)-{ 


printf(*No more messages\n”) ; 
break; 
b> eles 4 


printft(“td messages left (%d 


bytes) on. gq od\n", -alr.msgqnum, at 
PamMsg “COYTCES,;. “Gqa) 7 
} 
Pb Slise, 


perror("msgerl STAY: dequeue” ):; 


} 


printf (“Server de-queued q %d\n”, qaqd); 
free (xsg) ; 
} /* dequeue */ 


46 


The Client Code 


Our queue manager, as coded above, will work 
stand-alone, and GET and PUT messages to the two 
queues it created. What it won’t do, is to forward the 
messages to remote sites. This is because, it needs 
to behave as a client in order to do that. 


The following code creates a standalone client, 
which we can be used in place of the ‘user 
application’, and which the reader is encouraged to 
incorporate, as a set of functions, into the queue 
manager. 


First, we need much the same definitions, as we did 
with the server: 


Seruce, SOckadd:: an ‘sa; 


SELUCE Nostent- *hp; 
struct servent *Svc; 
iit “ay. -S3 

char hostname[2048]; 
unsigned short portnum; 
char but [6192] > 
unsigned char *token; 
int nread; 

int nwrite; 

char mode; 

char queue[23]; 


char sreritle [i255 | 


SLLUCE- -GQOata: 7 


LONG “hyp? /* OQ=lst on gueue, n=lst 
of type n, -n=lst of <n */ 
Ghar tse (e927 |s 
be 
int qd, qe; /* forward, reverse 
queues */ 
struct, xms¢q { [* Cate From: FCP7 IP *7 
char mode; pe LS OGET,. (0: = PUT 47 
char gqname[23]; /* MQ1l=inbound 


MQ2=outbound */ 
int length; 


struct gqdata mesg; 


4/ 


SELuCcC. SMSC ims, 


Tir. “Srnec s 


Chak “S07 


main(argc, argv) je Tada: 7 

ACD. <eale Gar 

Clark “Fe ecoy 

{ 

unsigned char *p; 

icice ales 

te ag: = 105 

int slen = 1000000; /* socket buffers */ 


Ee Caro <2. )4 


rintf(“Usage: mqclient <host> <queue> 


<1=GET|O=PUT> [file]\n”); 
exit(-1); 
} else { 

Strepy (hostname, argv) |); 

strepy (queue, argv[2]); 

mode = argv[3] [0]; 

if(argce == 5){ 
ite (mode: =— “02 -):4 

SULrepy (Srerile, argqvi4))4 

} else { 


printt Wrong mode Sss<\n", 
argv[3]); 


exit(-1); 


brant? (Clicnt connecting to host. 2s in"; 
hostname); 


if((hp = gethostbyname (hostname) ) == 
NULL) { 


perror (“gethostbyname”) ; 


exit Ll) > 
} 
if((svc = getservbyname (“ingreslock”, 
“tcp”)) == NULL) { 


printi (“ss doesn't. exist \n”); 


exit(-1); 
}; else 4 
POrFUNUM — SVC-7S._ Porte; 
} 
memseb(esa, *\0",- Sirzeor(sa)) > 


memcpy ( (Char *)Gsa.sin addr, hp=eh addr, 


hp->h length); /* set address */ 
SasSin tamily = hnp-shcaddrtype; 


Sao DOt = bons (4: Shere) pOrenum), 


ie. =* SOCKEE(hO=7h. addi rype, 
SOCK STREAM, 0)) < O){ 


PeEror( SOCcket )7 
exite(a 1) 
} 


SQL SOCKET, SQ RCVBUF, 


1f(setsockopt(s, 
< Q) { 


(void *)&slen, sizeof(slen) ) 
perror(“Client setsockopt”) ; 


} 


SQL SOCKET, SQ SNDBUF, 


if (setsockopt(s, 
=. OY f 


(void *)&slen, sizeof(slen) ) 
perror (“Client setsockopt”) ; 


} 


if (connect (s (struct sockaddr *)&sa, 
) 


sizeof(sa)) < 0 


J 
{ 
printf(“Unable to connect to %Sd\n"”, 
POLTNUM); 
Perron, Connect” );7 


close (Ss); 


exit(-1); 
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/* assemble the token */ 


strcepy(msg.qname, queue) ; 

msg.mode = mode; 

msg.length = 0; f® ENS 
gets set in readmsg() */ 


msg.mesg.typ = 9; EM QrOrerary 


LOSCnELLLCakivon. number. */ 


if (mode == ‘0’){ /* get that 


which we wish to PUT */ 


readmsg(&msg, srcfile); 


token = (unsigned char *) &msg; 


1f((nwrite = send(s, token, sizeof(struct 
xmsg), Q)) < Sizeor (Struct xmsc)) { 


Derrore(“Wiive. to socket); 
exit (=1) 7 


} else f /* the write 


succeeded */ 


printf(“Client sent td byte 
token:>%s<\n”, nwrite, token); 


if (mode == *1’){ 
/* we asked to read msgs */ 


printf (“Client waiting to read 


queue...\n”); 
memset (buf, ‘\0’, sizeof (buf)); 
flag = 0; 
while((nread = recv(s, buf, 

Sa veor( DUE). - Oy) S20) 4 


printf (“\nRead %d byte 
message:\n”, nread) ; 


for(i. = Os. 4. < nréad: it+) 4 


Preineet 2c, bur lal)¢s 


if (buf[1i] == EOF && 
burl tel). S= 9\0"): a lag = ss 
} 
if(flag == 1) break; 


memset (buf, ‘\0O’, 


S1Z2Z6E60f (Dur): ) 


} 


printf (“\nReceived messages\n”) ; 


o\° 


} else { pirrmtt ("se*, burl); 


/* no reply needed */ 


} 
;* ao nothing +7 


Prarie (ia. 
} else { 


perror(“Read XML”); 
close .s); 


return (-1); 
} /* main */ 


} 
Now, we need to have our application read in 


arbitrary data (like double-byte XML), and set it into 
our data structure for transmission. The following 
trivial function accomplishes this: 


CLOGSEe(LaG) 3 


/* readmsg */ 


KAKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKHK 
KAKKKKKKKKKKKKKKKKKKKKKKKKKKKKK 


* Reads a double-byte XML message froma 
file, and appends it to the 


x TLOKCHY array. 


KAKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKIKKKKIKK 
KK KK KK KK KK KK KK KK KK KK KK KK KK / 


readmsg (where, file) [es 
readmsg */ 


struct xmsg *where; 
About The Author 


char *file; 
{ Mark 


Sitkowski is 
a Chartered 





rn anne Engineer and 
Te. a a Corporate 
Member of 
the Institution 
Ie (EC = Openiale,;, © RDONLY):) == =L)4 


of Electrical Engineers in London. His early 
printf (“Can’t open %s\n”, file); career revolved around the writing of 
analog and digital circuit simulators, and 
digital signal processing applications. In 
Australia, he moved to writing financial 
if((nread = read(fd, buf, sizeof(buf))) > software for the major banks, and 
telecommunications software for Telcos, 
besides conducting training courses on 


return (=); 


} 


/* we assume the message is never Unix and database applications. Formerly 
bigger than the buffer */ : 
a consultant to Forticode Security, he 
where->length = nread; currently works with Design Simulation 


Systems on mobile multi-factor 


| authentication systems. Design Simulation 
printf (“Read d byte message:\n”, 


where->length) ; systems Ltd 
nenepytunere--meseeiee. bee. areca): http://www.designsim.com.auxmarks@exe 
mail.com.au 
for(1 = 0; 1 < nread; i+t+){ 
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Me 





ISAs UE Sy ge 
a as 


Want to know how to get started and configure a working home server? 





Do not wait for a better moment! 


Learn TODAY how to use the current ZFS capabilities to help us build a home file 
server using FREEBSD 10.3 


BLOG PRESENTATION 


OpenBSD From a Veteran 


Linux User Perspective 


Dear BSD Readers, 


I'm a Computer Engineer and entrepreneur. I've 
loved computers since | was a kid. My first machine 
was a 386 with 2 MB of RAM which ran DOS, and 
since then, I've used about every possible machine 
and OS that's available. | studied Computer 
Engineering in Barcelona and then | worked for 8 
years analyzing bioinformatics data using machine 
learning. After leaving that job, | then had some 
sabbatical time, during which | started some projects 
and learned to use new tools, languages, and 
systems. My dream has always been to find an Al 
startup. While in college, 15 years ago, this was an 
almost foolish idea. However, thanks to the 
proliferation of tools and libraries, the 
commoditization of GPUs, and the focus on Al 
verticals, the Al field is growing strongly, and there 
are many market opportunities to apply machine 
learning to the enterprise. I’m now a founder at 
Optimus Price, an Al-powered price recommender 
for e-commerce: https://optimusprice.ai. You can 
learn more about me at my page: 


https://cfenollosa.com 


Interview with Carlos 
Fenollosa 


Can you tell our readers about yourself and your 
role nowadays? 


I’m a founder at Optimus Price, a startup that 
develops a SaaS for dynamic price 
recommendations powered by Artificial Intelligence. | 
am the CEO which means that, as an engineer, I've 


o1 





had to learn many new skills: business development, 
sales, management, administration and finances. It's 
a whole new world, and a very interesting one; 
businesses are a big pillar of today's world, and | 
believe that a deep understanding of how they work 
complements well the technical world and lets you 
grow as a person. 


How you first got involved with programming and 
the OpenBSD world? 


| first used a computer around 1992. It was an 
obscure brand 386 laptop with 2 MB of RAM that | 
used to "borrow" from my father when he wasn't 
looking. My main stack was DR-DOS and later 
Windows 3.1. We had to use what our parents 
bought, usually cheap software and games, or 
software copied from friends. Obviously, we didn't 
have any Internet, so the only way to learn was by 
reading library books and computer magazines. | 
typed numerous QBasic listings by hand and 
ultimately learned how to write my programs. Now 
we jump forward in time for more than 20 years. 
After quitting Windows and using Linux and OSX 
exclusively for some time, | wanted to learn more 
about UNIX systems. | experimented with FreeBSD 
and OpenBSD, and liked both, but | really loved the 
simplicity of OpenBSD. | found that it had more 
differences from its cousin Linux than | expected, 
and that’s why | wrote the article "OpenBSD from a 
veteran Linux user perspective’: 


https://cfenollosa.com/blog/openbsd-from-a-veteran 
-linux-user-perspective.html 


While having a wide field of expertise, please tell 
our readers on which area you put the most 
emphasis and why? 


lam probably best at designing and developing 
software products. Solving problems with software is 
my passion and what | do best, from small scripts to 
bigger systems. 


What was your the best work? Can you tell what 
was the idea behind it? What was its purpose? 


Maybe not my best, but | developed Bashblog, a 
blogging engine in a 500 line bash script to scratch 
my own itch. | wanted to write “./bb.sh post”, write 
some Markdown text, and get it converted to a 
single entry linked from an index page. | published it 
on Github (https://github.com/cfenollosa/bashblog), 
and it quickly grew in popularity. Now, it’s mostly 
finished and it has a great community around it. It is 
definitely my most successful free software project. 


What is the most interesting issue you’ve 
encountered, and why? 


While working at the Barcelona Supercomputing 
Center, we had all office machines on an SGI cluster 
to launch long jobs overnight. However, one very 
specific job failed randomly. Long story short, after 
about a week of debugging, we discovered that 
some of the machines had a CPU which didn’t 
support a very specific CPU opcode. Even though 
the software was a Python script, one of the libraries 
(numpy) had been compiled on a machine with that 
opcode, so it segfaulted on older CPUs. 


What was the most difficult and challenging event 
in your life? Could you give us some details? 


Probably having to sell my product to people. As a 
product person and an engineer, | was terrified the 
first times | met with clients and tried to sell them my 
product. It turns out that selling is another skill you 
can learn, and clients appreciate meeting with an 
engineer and not a salesperson, it gives you more 
credibility. 


What future do you see for FreeBSD and other 
OSes? Can you tell us about your favorite 
features in the new releases. 
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| think the future will bring a clear divide between five 
product families: laptops/desktops, servers, mobile, 
and lol. The BSDs have a fairly good market share 
on the server, but they will probably remain a niche 
in laptops and desktops as they are today. | don’t 
think they will lose market share, though. The big 
question is the future of mobile and loT. Mobile is 
now dominated by Android and iOS, and having 
been a developer of both, | can see Android evolving 
heavily or being replaced by something else in the 
future. I’m not sure if it will be another iteration of 
Linux or a BSD, but its current architecture and 
extreme fragmentation both by device and 
manufacturer has many problems. Regarding loT, we 
all have seen what happens when you deploy tiny 
CPUs with nonexistent security and flawed OSs and 
services. This is a clear opportunity for the BSDs. 
The embedded world will evolve to more powerful 
and power-efficient chips, and an embedded BSD 
kernel + userland would be very attractive. 


Do you have any specific goals for the rest of this 
year? 


| want my company to grow and be able to deliver a 
great product. If only | could find some time to 
improve on my github projects... 


What’s the best advice you can give to the BSD 
magazine readers? 


The BSD magazine audience is probably much more 
skillful than me in many respects, so maybe | can 
give some advice regarding product development. It 
is definitely true that it takes 80% of the 
development time to finish up the last 20% features 
to launch a product. However, that is also the time 
you need to show your still unreleased prototype to 
your target market, be it a company or just some 
fellow developers. Otherwise, you will waste your 
time developing a product that only works for you. 
This is not wrong per se, but you will miss out on the 
enjoyment of watching other people use the product 
you ve worked so hard on. 


Thank you 


Thanks for reading! 


OpenBSD From a Veteran 
Linux User Perspective 


For the first time, | installed a BSD box on a machine 
| control. The experience has been eye-opening, 
especially since | consider myself an "old-school" 
Linux admin, and I've felt out of place with the latest 
changes on system administration. Linux is now 
easier to use than ever, but the administration has 
become more difficult. There are many components, 
most of which are interconnected in modern ways. 
I'm not against progress, but | needed a bit of 
recycling. So instead of adapting myself to the new 
tools, | thought, why not look for modern tools which 
behave like old ones? This article discusses some of 
the main differences between OpenBSD and Linux, 
from a Linux admin perspective. There are some 
texts on the net discussing the philosophical 
differences between BSDs and Linux, but not many 
of them are really hands-on. [his one is the best, 
and | recommend you to read it along with this one. 
Since | am new to OpenBSD, | may get some things 
wrong. Please email me any corrections. However, 
my goal is to point out my first impressions. 
Therefore, if there are any Linux users reading and 
thinking about making the jump, they can know what 
to expect. 


The "RAMDAC" running joke 
First, some background about my Linux experience. 


My first computer was a 386 with DOS and Windows 
3.1. | had played with Spectrums, Commodores, and 
IBM PCs (8086). | followed the traditional Windows 
path: 3.1 -> 95 -> 98 -> ME -> 98 -> 2000. But | 
always liked computers, and the most visible part of 
them, besides the hardware, is the OS. | tried to 
install my first Linux distro on 1999. It was a Red Hat 
Linux 5.2, if | remember correctly, | got the CD from 
a magazine because | was still running a dial-up. | 
was 15 and | thought | knew computers, after all, | 
had assembled my own, an AMD K6-2 box, from 
parts. 


Red Hat proved me wrong. 


Which ts your chipset? 


Man, | didn’t know 
Which is the model of your RAMDAC? 
What is a RAMDAC? 


[| need your monitor modelines. Don't get them 
wrong or you will physically damage your CRT 


Dude, I'm 15, | can't afford to break anything! 


In the end, | didn't break my monitor, but got a black 
screen which said login:, and didn't Know what to 
do, so | booted back into Windows and played a bit 
of Warcraft 2. 


In that age, we only had one computer. So if you 
were installing something and needed help, you had 
to stop, reboot into Windows, dial up the modem, 
search the Usenet or forums, write down the solution 
on a piece of paper—no ubiquitous printers—, hope 
you got the commands right, reboot, start the 
installation over, reach the point where you 
previously were, and apply that solution. Not 
practical at all. 


The best help we had were books, and those were 
expensive and difficult to find in a small town 
bookstore. For those of us not fortunate enough to 
buy/find books, we had hobbyist magazines. In 
Spain, there were a few imported and poorly 
translated magazines which were expensive, but 
carried some CDs, the only practical way to get 
distros. 


The first Linux | was able to use was Mandrake 6.0. 
It had a graphical installer—not that having graphics 
made any real difference to the final result— but it 
auto-detected my hardware correctly and booted 
into X. Yeah! Old Linux software! A game called 
Nethack which had nothing to do with hacking! 
sysconfig! 


Unfortunately, | couldn't connect to the internet 
because of my Winmodem. Thus, after a few days of 
tinkering, Mandrake was wiped too. 


Months later, | got myself a BeOS CD. It was like 
Linux, which for me, then, meant it was not 
Windows. The setup ran totally effortless and it even 
detected my Winmodem. The internet ran faster than 


on Windows. It had a great internet browser, mail 
and newsgroup clients. Oh, boy! | used BeOS for a 
long time almost exclusively and only booted 
Windows to play some games. 


A couple of years later, | started Computer 
Engineering in college. So, | wiped out everything 
and installed Linux. | got anew machine and a real 
network connection. 


I've run lots of Debians, Red Hats, Mandrakes, 
Gentoos and Slackwares. We used Solaris and even 
some VAXes. | ran some servers for student 
organizations, and finally settled on Debian as "the 
best" distro: stable, easy to use, no need to compile 
on our 486, nice hardware detection and with a big 
community. Finally, | moved to Ubuntu, only 
because of its LTS releases. Around 2006, | got into 
Macs, which at first seemed like a nicer Linux, and 
now | appreciate the hardware+software combo for 
which | know | won't have to fight with its drivers. 


In summary, I've seen a lot on UNIX, even more on 
Linux, and administered a good chunk of them. My 
servers have always run some sort of Debian. You 
could say that as | grew older, | also grew tired of 
fighting with RAMDACs, modelines and 
Winmodems. Each age brought new "RAMDACs'": 
CD recording, wireless card support, laptop 
hibernation, webcams, Divx playing, DVD playing, 
NTFS support etc. Linux always worked on the 
server but had some quirks in the desktop which 
made it somewhat unattractive for daily use, even 
when | run it exclusively on my laptop. Nowadays, 
Macs offer a UNIX with some peace of mind, and the 
current status of Linux is good enough. Some of the 
friends | evangelized long ago—| quit doing that— 
still use Ubuntu and are happy with it. Linux may 
never triumph on the desktop (or laptop), but it's 
good enough for most. 


Upgrading a G4 Mac Mini 


Now jump to 2015. My home server, a G4 Mac Mini, 
was already two Debians behind. Some packages 
weren't ported to powerpc. | needed to perform a 
clean install and upgrade the whole system either 
way. But this time, | didn't want to use a Linux 
installation which wants me to reboot every 5 days 
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because of some critical patch. I'm looking at you, 
Ubuntu. 


As you can imagine, my operating system 
fascination didn't fade out, only my time. | had been 
closely following the BSDs and using a NetBSD shell 
account, installed Plan 9 on a virtual machine, and 


even wrote a toy OS project. 


I'm not afraid of compiling stuff—| do it for a living— 
and may even be open to modifying some code if 
needed. Why not try something new? Since | had the 
weird powerpc requirement, | ruled out most 
operating systems. Finally, | decided to play 
relatively safe and go for a BSD. FreeBSD is the 
most popular, has more online HOWTOs, and 
probably more features (ZFS, Jails etc.), though | 
probably would not be using them. OpenBSD is 
more hackable, seems to have better 
documentation, and some cool people | know who 
use it. | didn't want to quit using a pot to start using 
a kettle, so | downloaded OpenBSD's install57.iso It 
was impossible to boot the Mini with a USB stick; 
I'm unsure if It's the firmware's fault or the fact that | 
was adding the .iso file into the USB instead of the 
.fs one which didn’t seem to be available for 
macppc. 


| found some blank DVDs on a closet, borrowed a 
computer with a DVD drive—another medium | 
hadn't touched in years—, and burned the ISO 
image. The fact that | recorded the first disk with the 
ISO file on the root folder instead of properly burning 
the contents into the DVD warned me that this was 
going to be hard, but fun. Surprisingly, the 
installation was straightforward. It detected the 
10-yr-old hardware, and by following the 
instructions, | managed to partition the disks and 
install the boot loader. Eventually, the box was up 
and running. Well, that wasn't so hard, was it? Now, 
to restore my old installation. Hm, first of all, bash 
needs to be installed from packages and goes into 
/usr/local/bin. Therefore, | had to modify a lot of 
scripts which pointed to #!/usr/bin/env bash. The ps 
and tar commands have slightly different switches 
which broke other scripts. The base services are 
different; OpenBSD includes its own HTTR, SMTP 
and NIP servers. Configuration files are in different 
places. Here goes my week... 


GNU is really not UNIX 


A quick note on the GNU/Linux naming discussion, 
since GNU its entering the equation now. | use the 
term "Linux" for simplicity. | know that's the kernel 
name. It also happens to be the popular name, even 
if not totally correct— according to some. Here is 
some food for thought; why does the FSF deserve 
more credit on the name than, say, the Apache 
Foundation, or the FreeDesktop project, or BSD, for 
that matter? Why don't we include every key 
component of the name and call it 
GNU/FreeDesktop/Apache/OSI/BSD/.../Linux? 
Including only GNU would be unfair to other big 
contributors, wouldn't it? So, let's please stop this 
fight. That being said, the GNU tools and design 
ohilosophy make a noticeable difference in 
administration and userspace, and one can only 
appreciate it when switching to a different 
environment. | don't want to overstate it, though. 
Thanks to POSIX, a Linux admin can run BSD with 
little extra effort since most of the things are similar. 
There are, in fact, more similarities than differences. 
lf FreeBSD and OpenBSD are brothers, then Linux is 
a close cousin. Is is always Is. mkdir is mkdir. But 
when you're being used to /dev/hda, free -m and cat 
/proc/cpuinfo you realize that having a different 
Kernel is naturally going to change some of the 
administration tools. Some say that the GNU tools 
are bloated and that the BSD toolchain is more "pure 
UNIX". The reality is that it depends on the specific 
GNU tool. I've personally found that GNU tools are 
more complex because they're more powerful, 
though they are less UNIX-like (do one thing only 
and do it well) and more like complete solutions. 
That's fine; different, but fine. After all, GNU is not 
Unix! In recent years, the Linux environment has 
grown in the GNU toolchain fashion, not the UNIX 
fashion. One may even say it has grown in the 
Windows fashion: be practical, be accommodating 
to all, be fast, and be modern. There have always 
been debates about "bloated and complex code". 
More recently, systemd. Previously, Apache, 
sysconfig, iptables/iptools.... The list goes on and 
on. Wheel out comp.os.linux and look at the flame 
wars. No software fits all nor should be shamed for 
its design decisions. In the end, with a few critical 


exceptions like OpenSSL and the Heartbleed bug, it 
is just a matter of taste: does the admin prefer 
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simple, pluggable services, or bit monolithic suites? 
Compatibility or modernness? Familiarity or shiny 
new things? Standards or NIH? | had been riding the 
Linux wave for years, until | recently realized that my 
admin skills needed a total recycling. In a few years, 
we've gone from /etc/init.d/sshd restart to service 
sshd restart to systemctl start sshd. That's a bit fast 
in my opinion. However, | understand it's the price of 
progress aimed to make computers boot faster and 
theoretically easier to administer for newcomers. Old 
admins, on the other hand, have a harder time 
adapting. Having to choose between recycling into 
an always changing Linux or a more stable UNIX 
environment, | chose OpenBSD. Given my history of 
trying all possible OSs, Let me state again that I'm 
not against the recent Linux direction. | just wanted 
to go out and see if there is a different way to do 
things. 


Differences between OpenBSD and Linux 


Maybe you're reading this article for its practical 
value and not for my ramblings, sorry. | thought | had 
to provide some context. I'm used to googling, 
RTFMing, and to reading source code to learn what 
software does. This context is important to judge if 
you would notice the same differences as | did. 
Here's a list of things that surprised me the most 
after completing an OpenBSD install, adapting my 
old setup to the new environment and running it for a 
few days. 


Simplicity 


First of all, everything is much simpler, like the Linux 
old days. Not necessarily easier, but simpler. More 
minimalistic. | found this plays well with my mind. 
OpenBSD follows the UNIX philosophy more closely: 
lots of small components that do one thing and talk 
between them by passing text. Because of that, 
some base components are not as feature-rich, on 
purpose. Since 99% of the servers don't need the 
flexibility of Apache, OpenBSD's httpd will work fine, 
be more secure, and probably faster. For those who 
need the big boys, just install Apache from the 
packages. Having a developer-chosen default option 
for many servers is a time saver. The admin knows it 
will be well supported and documented, and tightly 
integrated with other components. The alternative, 
the Linux way, is to just use what everybody else 


uses (Apache), or choose one of the multiple 
options, always wondering if it's the right one— 
nginx? lighttpd? thttpd? You know what... nobody 
got ever fired for choosing Apache 


Design decisions 


Picking up on that thought, the system is very 
opinionated. When the community decides that 
some module sucks, they develop a new one from 
scratch. OpenBSD has its own NTPd, SMTPd and, 
more recently, HTTPd. They work great. Likewise, 
the standard shell is pdksh. The OpenBSD FAQ 
states that "Users familiar with bash are encouraged 
to try ksh(1) before loading bash on their system -- it 
does what most people desire of bash.", which is a 
bit too bold. ksh does not support history 
substitution (Sudo !!:1) which | use a lot, though | 
agree that for many users it will be enough. Many 
people hate bash for some reasons. | am not one of 
them. Having a super powerful shell has saved me 
from writing perl scripts for system administration. 
Bash can always be installed from packages, 
anyway. This is a big difference from Linux, which is 
more like a "consensus" operating system. 
Developers have to keep compatibility and whenever 
there is a controversial design decision like systemd, 
dozens of projects decide to fork. Not good. Strong 
opinions, on the other hand, also lead to less 
support for some, like ext4, ZFS or Linux binary 
compatibility. For example, ext4 is officially 
supported read-only but in my case it didn't read 
some folders properly. FreeBSD plays better on that 
regard, though they also have more developer 
manpower. This leads to some use cases, like an 
OpenBSD desktop, being possible but not the best 
choice for this OS. Finally, other decisions make little 
sense. According to disklabel(8), the /usr partition 
takes about 2G of disk space, not including /usr/src 
or /usr/obj. This means that there is little soace to 
hold what is essentially the whole system plus ports. 
| had trouble compiling large ports since /usr ran out 
of disk space. If a large number of users will be 
compiling some ports, why not set a larger /usr by 
default? 


Documentation 


The man pages are excellent, a delight. Unlike Linux, 
they are not just a list of switches for the software, 
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but a comprehensive guide to the tool, with lots of 
examples. They are much, much better—thankfully, 
because unlike Linux, again, there are not tons of 
help on public forums. OpenBSD's man pages are 
so nice that RIFMing, somebody on the internet is 
not condescending but selfless. Granted, | wouldn't 
make a UNIX novice run OpenBSD from man pages. 
But for an experienced admin, they contain exactly 
the information they need. 


Small differences in common tools 


Using the BSD toolchain instead of the GNU one 
means there are small differences between the tools. 
For example, some ps switches are missing, like the 
useful -f. The tar options for reading from stdin are 
also slightly different. When Is is run by root, it 
automatically appends all hidden files. 


df has -h (human) and -k (kilobytes), but no -m for 
megabytes. 


lf you've used MacOS you probably know a few of 
these. 


Packages 


OpenBSD has packages, like Linux. Unlike it, 
packages are only available for 3rd party software, 
not the base system. OpenBSD's base system is 
more or less what gets installed from the CDs: 
Kernel, shell, coreutils, a small part of X and essential 
servers (http, ntp, smtp, etc.) Everything else must 
be installed from packages. The documentation 
recommends using packages since it is not worth it 
to compile from ports—the package sources. 
However, packages don't get security updates. The 
only way to patch bugs is to compile the ports. 
Fortunately, there is a simple way to use the best of 
both worlds: add FETCH_PACKAGES=yes to 
/etc/mk.confand install software from ports. The 
system will automatically fetch the package and 
save the compilation time if there is a current binary 
available. Another interesting tool is 
/usr/ports/infrastructure/bin/out-of-date, which 
checks which ports need an update. So, you can go 
to /usr/ports/<portname> and make update. This 
command plays well with previously installed 
packages. Therefore, you don't have to worry 
deleting them first. 


In summary, after you install the release, if you're 
interested in getting security updates until next 
release, the officially recommended path is to follow 
-stable, use FETCH PACKAGES and work from 
ports. This is not very clear in the documentation but 
the folks at #openbsd helped me figure it out. As a 
colophon, if you're using x86 or amd64, m:tier 
provides binary updates for the base system and 
packages, much like Linux does. Otherwise, if there 
is any bug in the base system, you'll need to 
recompile that part yourself. The amount of 
compiling needed will be determined by the patched 
component and any related software. Hence, just 
read the instructions on the patch. 


Configuration files 


The base system config files are properly centralized 
in /etc, but not the ports. The porting quality is 
excellent, better than any Linux distro. Every port is 
adapted to the OpenBSD system and made sure it 
behaves correctly. However, some maintainers 
decide that all the port files need to be contained in 
some folder, like transmission-daemon, which stores 
its config into 
/var/transmission/.config/transmission-daemon/setti 
ngs.json. It's a bit crazy to store a system-wide 
daemon contig file into /var which, according to man 
hier, contains Multi-purpose log, temporary, 
transient, and spool files. Apparently some daemons 
are chrooted by default, and there is a global 
"catch-all" README folder on 
/usr/local/share/doc/pkg-readmes which contains 
specific info about packages. transmission-daemon 
had no related info, so maybe I'll contact the 
maintainer. 


Chroot 


Speaking of roots, nearly all daemons in the base system 
are chrooted and privstep by default. The base system 
has a lot of hardening by default, which is one of the 
main reasons why OpenBSD has almost no remote holes 
on the default installation. Since chrooting software in 
Linux can be cumbersome, it's very convenient to get it 
done for you, so thanks! 


Experienced community 


| feel like the learning curve is a feature, not a bug, 
intended to keep newcomers away. OpenBSD is 
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unapologetically elitist. Honestly, | don't mind that. 
I've been administering systems for more than a 
decade and not all environments are for everybody. 


OpenBSD can afford to be elitist because it is a 
small system, with a clear direction, the 
documentation is crystal clear, and it doesn't make 
vague promises. 


make build 


As you can see, there is a big con to using OpenBSD 
coming from a Linux world, the process for patching 
security issues. On Linux, | was used to run a single 
command and let any part of the system (base or 
3rd party) update itself. With OpenBSD, it takes a lot 
more effort and time, especially in my old machine. 
This process leaves the admin only one realistic 
option: follow the -stable branch, which is basically 
the same code as the CD release with small patches, 
and recompile stuff regularly. Otherwise, the installed 
system will be exposed to potential security holes 
until the next release. | feel that this needs to be 
more prominent in the OpenBSD docs, especially on 
the Migrating to OpenBSD section: if you want an 
updated and stable system you'll need to recompile 
stuff constantly, there is no equivalent to apt-get 
upgrade. To get a secure production system with 
OpenBSD, the officially recommended path is to: 


Install the CD release 


Download the source code 


¢« Recompile the kernel (recommended by "following 
-Stable") 


« Recompile userland 
¢« Download ports tree 


Add FETCH_PACKAGES=yes to /etc/mk.conf to let 
ports fetch packages, if available, and install 
software using the ports syntax. Recompile when 
there is a security issue which affects your setup, 
though you may skip some compiling if using m:tier. 
Of course, this is a feature, not a bug, but it's the 
biggest admin change from old Linux users. That's a 
lot of effort compared to apt-get update && apt-get 
upgrade. Honestly, had | known it, | would've more 
strongly considered keeping my Debian installation. | 


read all the online documentation before installing 
OpenBSD, and | felt like this point wasn't really clear. 
Since you can safely use -stable ports/packages 
with a -release base system, steps 3-4 can be 
avoided or shortened if you don't want to update 
your base to -stable. That's what | would 
recommend to former Linux users, but take this 
newbie's advice with a grain of salt. In any case, for 
low-performing machines like mine, maybe the 
"recommended" path to follow -stable and rebuild 
the source for every errata is not the best one. For 
small fixes, it may be better to apply the patch and 
follow its instructions. Apparently in faster machines, 
it's more convenient to recompile the base system 
since it takes just a few minutes. Had | been using 
x86 or amd64, I'd have totally gone for m:tier. So you 
can dismiss this section if that's your case. To be 
totally fair, it's rare for OpenBSD to have remote 
holes on the CD release. Thus, one could be 
relatively safe by only upgrading from release to 
release. But the truth is that there is no simple way 
to binary patch for critical updates unless using the 
third-party m:tier on one of the supported 
architectures. With that it mind, to summarize, 
consider the following options: 


Use a -release base and -stable ports (with 
FETCH_PACKAGES=YES), cherry-picking patches 
from base and updating ports by make update. This 
may be the recommended path for low-performing 
machines. 


Use a -stable base, too. You can then update the 
whole system with a handful of commands and 
won't need to follow patch instructions. 


Use -release and update from m:tier 


Keep using -release until a next -release comes, 
unless there is an unlikely remote hole that forces 
you to recompile the base. This may be the best 
option for newbies if the only person using the box is 
the admin, so there is no way to suffer local attacks. 


Conclusion 


From a user perspective, all of this is transparent; 
OpenBSD has a UNIX terminal or Xwindows session 
and everything works as expected. But a Linux 
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admin will need to adapt to these new tools and 
allocate some more time for administration. 


OpenBSD has pros and cons. Personally, my main 
pros are the excellent documentation, its minimalism 
and the choice of default daemons. The only con is 
the need to recompile to patch errata. If | had just 
one wish for OpenBSD, it would be a more 
straightforward updating system for security errata. 


Now, the dreaded question. /s it worth it? 


Honestly, | wasted too much time. Some of it was to 
be expected, since | needed to learn a different 
environment. Had | been 10 years younger, this 
wouldn't have been a problem, but my time is more 
limited now. The fact that | needed to compile things 
on an old machine probably didn't help. Keep that in 
mind when considering a BSD for an old, weird 
architecture. After the initial investment, | want to see 
if maintenance is easier and release upgrades are 
smoother than with Debian. Manually upgrading 
things is a pain in the neck, but all other factors lead 
me to think that OpenBSD is a great server OS. 
Maybe | was expecting something else from the 
docs | read. It is probably my fault, though. Anyway, | 
want to contribute to the available documentation by 
writing this document so that other Linux admins 
can make a more informed decision. On the other 
hand, my geeky side is content. OpenBSD rocks. It 
is a different—a real— UNIX and I've really come to 
appreciate simple code and software. As an admin, 
having minimalistic, default servers is a blessing. 
Again, should you try OpenBSD? The answer is yes, 
though be careful if you're either in a rush or have 
specific software requirements. The first days are a 
bit hard, and recompiling on a slow machine takes 
time. 


If you like UNIX, it will open your eyes to the fact that 
there is more than one way to do things, and that 
system administration can still be simple while 
modern. 


Revised with contributions from TJ and Mike. 
Thanks! 


INTERVIEW 





interview 
with Felix Weinrank 








Felix Weinrank is a computer scientist from Germany. 

He is currently a Ph.D student in the Department of 
Electrical Engineering and Computer Science at Munster 
University of Applied Sciences. His research interests 
include the SCTP transport protocol, low-latency 
Internet communication and network emulation. 


Can you tell our readers about yourself and your role nowadays? 


lama Ph.D student in the Department of Electrical Engineering and Computer Science at Munster University of 
Applied Sciences. 


Currently, | am involved in two research projects which are related to transport protocols. The first project, in 
cooperation with the University of Duisburg-Essen and funded by the German Research Foundation, seeks to 
improve the interaction of media and non-media streams in WebRTC peer-to-peer communication. 
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The second project, in cooperation with several European partners from universities and industrial companies, 
offers application developers a new and unified API for network communication. You will find more details at 


www.neat-project.org. 


How did you get involved with computer science? 


| was about seven or eight years old when | became fascinated by my father’s computer. | played around with it 
whenever possible — and | often broke it. 

So, he gave me an old second-hand Intel 486 and from then on, | was responsible to fix it. | learned a lot about 
the technical background and was always curious how the things work. 


While having a wide field of expertise, please tell our readers on which area you put the most emphasis 
and why? 


| put most of my emphasis on improving the SCTP protocol. 


It is very flexible with respect to the development of new extensions and can be used for many use cases. Since 
SCTP is part of the WebRTC stack, where it is used as the transport protocol for Data-Channels, it is widely 
deployed and integrated into almost every browser. 


What tools do you use the most often and why? 
First of all, the Atom editor. | like the balance between the lightweight design and the endless ways to extend it. 


Since | am usually programming code in C, there are a lot of tools involved. Git, Clang, Valgrind and LLDB, to 
only name some of them. 


In addition to writing real networking code, we are using the OMNeT++ discrete event simulator in combination 
with the INET framework. This allows us to implement and test new features before we integrate them into the 
operating systems. 


What was the most difficult and challenging issue you’ve done so far? Could you give us some details? 


The current tasks my colleagues from Essen and | are working on. While real-time media streams aim to have 
low delay, non-media streams always aim to use all the available bandwidth. These two behaviors are 
controversial and we are working on mechanisms to combine them in an optimal way. 


Do you have any specific goals for the rest of this year? 
To finish some research papers and successfully publish them. 


Thank you. 
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COLUMN 


The gig economy giant, Uber, has had Its operating licence suspended by 
Transport for London. Apart from concerns over the way the company 
operates, a more sinister reference was made to Greyball software which 
effectively tricked law enforcement and those Uber didn’t wish to deal 
with. Where should the line be drawn between good practice and 
deception? 


Rob Somerville has been passionate about technology since his early teens. A keen advocate of open 
systems since the mid-eighties, he has worked in many corporate sectors including finance, automotive, 
air- lines, government and media in a variety of roles from technical support, system administrator, 
developer, systems integrator and IT manager. He has moved on from CP/M and nixie tubes but keeps a 
soldering iron handy just in case. 


For many years | have worked at the edge of the envelope where the bad guys reside. As a webmaster, 
developer and security specialist, | have absolutely no time for those that choose to reside on the dark side and 
profit from the misery of others, be that intellectual, financial or just pure ego and one-upmanship. 
Undoubtedly, all serious IT professionals have messed around at some stage pulling IT related pranks on 
colleagues and peers (my personal favourite was editing command.com with a hex editor, and changing the 
error messages around) but with no long term damage, and a wry smile and a laugh on both sides. So, I'll be 
the first to admit when | come across a particularly cunning and devious piece of malware my first reaction 
(after using a few choice words and picturing a particularly gruesome scenario involving the perpetrator) is to 
respect the innovation, creativity and the “in your face” sheer audacity. 


And so it is with the Silicon Valley incubators, innovators and disrupter’s. While the investors and venture 
capitalists look for the next and best opportunity (the cunning of the malware), few sit back and look objectively 
at the subtle and not so subtle changes that are going on behind the scenes. Google faced this same dilemma, 
by setting information free the whole concept of property rights and intellectual ownership were thrown into 
question. It has battled through though, and the general perception of the organisation is now one of the 
benevolent dictator, with a huge insurmountable market share. Too big to fail, Google teeters between 
innovation and establishment, almost suffering from an identity crisis that the market interprets as edgy. 


Uber on the other hand, while an innovator, has required to morph into an entirely different giant than Google. 
Whereas little of Google’s current territory was occupied, Uber has had to crush the opposition, and like some 
form polymorphic virus change the classic business model so that the competition cannot challenge it legally or 
competitively. Whereas Google is much more an ethereal company, only contacted via our keyboards and LCD 
screens, you sit in an Uber and chat with the driver. Be it Google or Uber, however, the hidden hand of 
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technology is at work behind the scenes. Whereas Google’s focus is based on openness and sharing, Uber’s is 
based on sharing and efficiency. Few people pay Google money. Every Uber user must. So, the model has to 
be subtly different, despite the common goal of world domination and at the same time, busting through 
preconceived ideas and moral frameworks. While Google can occupy like a settler in a new land, Uber must 
oush aside and crush the opposition. For both sides, realize it is one or the other, old school or new school. 


Hence, a very nasty taste is left in one’s mouth when encountering such commercial tactics as Greyball. From a 
purely brand and customer support angle it flies in the face of good practice. After all, if you can win over a 
dissatisfied customer not only will you have secured a degree of loyalty that money can’t buy, but you will have 
built that ethereal, invisible quality that “the brand” encapsulates. Think of unicorn, rainbows and chocolate. 
But no, not only does Uber want to choose who its customers are, but also what level of weighing justice 
performs with her scales. It is the ultimate in passive aggressive tactics, contempt disguised as nonchalance. 


I’m an old-fashioned kind of guy, and | believe wholeheartedly in the rule of law, provided that the law is applied 
equitably to everyone, including corporations and individuals. Tax questions aside, | don’t think Google would 
have the bare faced cheek to stick the middle finger up to the established order in the same way that Uber has 
achieved with Greyball. Though, it is interesting that after Dara Khosrowshahi, the Uber CEO, had apologized in 
writing, the Mayor of London welcomed the re-opening of dialogue with Transport for London. Money talks, and 
being accused of not being a fit and proper operator will obviously cost the company dearly if it loses London, 
which will worsen if other major cities decide to follow suit. Maybe, Uber has just walked into the hallowed 
arena, where they are too big to fail, least of all in the perspective of adding cultural value to the capital of 
England. In a sense, they have outmaneuvered Google by being more evil yet at the same time closely following 
in the path their geographical peer has hewn in the rock. 


At the end of the day though, the whole moral and ethical question boils down to progress. As individuals, 
consumers and technologists, our decision must be a holistic one — how much progress are we willing to 
accept in hardware, society and our understanding of right and wrong? How long can an organisation that has 
such power and influence remain impartial until their true motives are revealed? Google, after all promoted itself 
on the basis of “Do no evil’. | don’t think that it is an overestimation to say that particular rhetoric is increasingly 
being questioned, and the historical fact remains that large, innovative tech companies eventually swallow the 
kool-aid of the military-industrial complex and end up in the fetal position in the quiet obscurity of the corner. 
Think of IBM and HP. At one point, these companies, like Google and Uber are currently, were innovators. While 
there might be the occasional flash of inspiration, they have sunk into the swamp of safety, conformity, 
establishment and the bedrock of the pension fund. Risk adverse, grey haired and creaking a bit at the joints. 
And | have no doubt that both Google and Uber will eventually follow that path as well, given sufficient time. 
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In this course we will teach you : 
: understanding python and how to install it 
: understanding python virtual environments 
using the interpreter and running a python script 
: advanced text editors for coding 


. understanding basic python data types 


: Knowing what classes are and how to use them 
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: Knowing how to get data from a publicly accessible API 
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